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Preface 


DevOps is a buzz word in 2015 and will be for the coming years as per market trends 
by various research firms. In DevOps culture, business owners, development teams, 
operations teams, and QA teams collaborate to deliver outcome in a continuous and 
effective manner. It enables the organizations to more quickly grab opportunities and 
reduce the time taken to include customer feedback into new feature development or 
innovation. The end goal of DevOps is to reduce the time between the initial concept 
and the end result of the concept in the form of production ready applications. 
DevOps targets application delivery, new feature development, bug fixing, testing, 
and maintenance releases. It improves efficiency, security, reliability, predictability, 
and faster development and deployment cycles. It covers all SDLC phases from 
development, test, operations, and release. 


Continuous integration (CI) and continuous delivery (CD) are a significant part of 
the DevOps culture. Jenkins is a fully featured technology platform that enables 
users to implement CI and CD. This helps users to deliver better applications by 
automating the application delivery life cycle. CI includes automation of build, test 
and package processes. CD includes the application delivery pipeline across different 
environments. Jenkins enables the user to utilize continuous integration services 
for software development in an agile environment. Continuous integration systems 
are a vital part of the agile team because they help enforce the principles of agile 
development. Continuous Integration is a significant part of the DevOps culture, 
and hence, many open source and commercial tools for continuous delivery utilize 
Jenkins or provide integration points. Jenkins enables agile teams to focus on work 
and innovations by automating the build, artifact management, and deployment 
processes, rather than worrying about manual processes. It can be used to build 
freestyle software projects based on Apache Ant and Maven 2 / Maven 3 projects. 
It can also execute Windows batch commands and shell scripts. 
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There are a number of ways to install Jenkins, and it can be used across different 
platforms such as Windows and Linux. Jenkins is available in the form of native 
packages of Windows, FreeBSD, OpenBSD, Red Hat, Fedora, CentOS, Ubuntu, 
Debian, Mac OS X, openSUSE, Solaris, OpenIndiana, Gentoo, or in the form of 

WAR file. The quickest and easiest way to use Jenkins is to use the WAR file. It can 
be easily customized with the use of plugins. There are different kinds of plugins 
available to customize Jenkins based on specific needs. Categories of plugins include 
source code management (that is, Git Plugin, CVS Plugin, and Bazaar Plugin), 

build triggers (that is, Accelerated Build Now Plugin and Build Flow Plugin), build 
reports (that is, CodeScanner Plugin and Disk Usage Plugin), authentication and user 
management (that is, Active Directory Plugin and Github OAuth Plugin), cluster 
management and distributed build (that is, Amazon EC2 Plugin and Azure Slave 
Plugin), and so on. 


Jenkins is very popular among its users as it allows them to manage and control 
phases such as build, test, package, and static code analysis. It has won InfoWorld 
Bossies Award, 2011; O'Reilly Open Source Award, 2011; ALM&SCM; and so on. 
The main users of Jenkins are NASA, Linkedin, eBay, and Mozilla Foundation. 


The following are some features that make Jenkins very popular: 


e Anopen source tool with a web-based GUI. 
e A Java-based continuous build system —easy to write plugins. 


e Highly configurable tool—a plugin-based architecture that provides support 
to many technology, repositories, build tools, and test tools. 


e The Jenkins user community is large and active. It has more than 1,000 open 
source plugins. 


e This supports CI for .Net, iOS, Android, and Ruby development. 

e This supports common SCM systems such as SVN, CVS, Git, and so on. 

e This supports common test frameworks such as Junit, Selenium, and so on. 
Jenkins speeds up the application development process through automation across 


different phases such as build, test, code analysis, and so on. It also enables users to 
achieve end-to-end automation for an application delivery life cycle. 
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What this book covers 


Chapter 1, Exploring Jenkins, describes in detail the basics of continuous integration 
and provides an overview of Jenkins. This chapter also describes installation and 
configuration of Jenkins. It takes a jump-start tour through some of the key features 
of Jenkins and plugin installations as well. It will also cover the deployment pipeline 
and the rest of the chapters will cover implementing it. 


Chapter 2, Installation and Configuration of Code Repository and Build Tools, describes in 
detail on how to prepare runtime environment for application life cycle management 
and configure it with Jenkins —an open source continuous integration tool. It will 
cover how to integrate Eclipse and code repository such as SVN and Git to create a 
base for continuous integration in the deployment pipeline, which is explained in 
Chapter 1, Exploring Jenkins. 


Chapter 3, Integration of Jenkins, SVN, and Build Tools, describes in detail on how to 
create and configure build jobs for Java applications, and how to run build jobs and 
unit test cases. It covers all aspects of running a build to create a distribution file or 
WAR file for deployment. 


Chapter 4, Implementing Automated Deployment, covers one step forward in the 
deployment pipeline by deploying artifacts in the local or remote application server. 
It will give insight into automated deployment and continuous delivery process, and 
also cover how to deploy applications on a public cloud platform using Jenkins. 


Chapter 5, Hosted Jenkins, describes how to use Jenkins on Platform as a Service (PaaS) 
model, which is provided by popular PaaS providers such as Red Hat OpenShift and 
CloudBees. Considering CloudBees, it also covers details on how various customers 
are using Jenkins based on their requirements. This chapter will explore details on 
how to use Cloud-related plugins in Jenkins for an effective use of Jenkins. 


Chapter 6, Managing Code Quality and Notifications, covers how to integrate static code 

analysis behavior into Jenkins. Code quality is an extremely vital feature that impacts 
an application's effectiveness, and by integrating it with Sonar, CheckStyle, FindBug, 
and other tools, you can get an insight into problematic portions of code. 
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Chapter 7, Managing and Monitoring Jenkins, gives an insight into management 

of Jenkins nodes and monitoring them with Java Melody to provide details on 
utilization of resources. It also covers how to monitor build jobs configured for Java 
applications and managing those configurations by keeping its backup. This chapter 
discusses the basic security configuration that is available in Jenkins for better access 
control and authorization. 


Chapter 8, Beyond Basics of Jenkins - Leveraging "Must-have" Plugins, covers the 
advanced usage of Jenkins that are extremely useful in specific scenarios. 
Scenario-based use cases and usage of specific plugins that help development 
and operations teams are covered here for better utilization of Jenkins. 


What you need for this book 


This book assumes that you are familiar with at least Java programming language. 
Knowledge of core Java and JEE is essential. Having a strong understanding of 
program logic will provide you with the background to be productive with Jenkins 
while using plugins of writing commands for shell. 


As an application development life cycle will cover lots of tools in general, it is 
essential to have some knowledge of repositories such as SVN, Git, and so on; 
IDE tools such as Eclipse; and build tools such as Ant and Maven. 


Knowledge of code analysis tools will make jobs easier in configuration and 
integration; however, it is not extremely vital to perform the exercises given 
in the book. Most of the configuration steps are mentioned clearly. 


You will be walked through the steps required to install Jenkins on a Windows- 

and Linux-based host. In order to be immediately successful, you will need 
administrative access to a host that runs a modern version of Linux; CentOS 6.x is 
what will be used for demonstration purposes. If you are a more experienced reader, 
then a recent release of almost any distribution will work just as well (but you may 
be required to do a little bit of extra work that is not outlined in this book). If you do 
not have access to a dedicated Linux host, a virtual host (or hosts) running inside of 
virtualization software such as VirtualBox or VMware workstation will work. 


Additionally, you will need access to the Internet to download plugins that you do 
not already have and also have Jenkins installed. 
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Who this book is for 


This book targets developers and system administrators who are involved in the 
application development life cycle and are looking to automate it. Developers, 
technical leads, testers, and operational professionals are the target readers to 
jump-start Jenkins. Readers are aware of the issues faced by the development and 
operations team as they are stakeholders in the application life cycle management 
process. The reasons to jump-start Jenkins are to understand the importance 

of contribution in continuous integration, automated test case execution, and 
continuous delivery for an effective application life cycle management. 


Conventions 


In this book, you will find a number of styles of text that distinguish between 
different kinds of information. Here are some examples of these styles, and an 
explanation of their meaning. 


Code words in text, database table names, folder names, filenames, file extensions, 
pathnames, dummy URLs, user input, and Twitter handles are shown as follows: 
"Commit by executing git commit -m "Initial Commit" -a." 


Any command-line input or output is written as follows: 


[root@localhost testmit]# service httpd restart 
Stopping httpd: 
[ OK ] 


New terms and important words are shown in bold. Words that you see on the 
screen, in menus or dialog boxes for example, appear in the text like this: "Once the 
build has succeeded, verify Workspace in the build job." 


[ % Warnings or important notes appear in a box like this. | 


[ Q Tips and tricks appear like this. ] 


[ix] 


Preface 


Reader feedback 


Feedback from our readers is always welcome. Let us know what you think about 
this book — what you liked or may have disliked. Reader feedback is important for 
us to develop titles that you really get the most out of. 


To send us general feedback, simply send an e-mail to feedback@packtpub.com, 
and mention the book title via the subject of your message. 


If there is a topic that you have expertise in and you are interested in either writing 
or contributing to a book, see our author guide on www.packtpub.com/authors. 


Customer support 


Now that you are the proud owner of a Packt book, we have a number of things to 
help you to get the most from your purchase. 


Errata 


Although we have taken every care to ensure the accuracy of our content, mistakes 

do happen. If you find a mistake in one of our books — maybe a mistake in the text or 
the code — we would be grateful if you would report this to us. By doing so, you can 
save other readers from frustration and help us improve subsequent versions of this 
book. If you find any errata, please report them by visiting http: //www.packtpub. 
com/submit -errata, selecting your book, clicking on the errata submission form link, 
and entering the details of your errata. Once your errata are verified, your submission 
will be accepted and the errata will be uploaded on our website, or added to any list of 
existing errata, under the Errata section of that title. Any existing errata can be viewed 
by selecting your title from http: //www.packtpub.com/support. 


Piracy 

Piracy of copyright material on the Internet is an ongoing problem across all media. 
At Packt, we take the protection of our copyright and licenses very seriously. If you 
come across any illegal copies of our works, in any form, on the Internet, please 
provide us with the location address or website name immediately so that we can 
pursue a remedy. 


Please contact us at copyright@packtpub.com with a link to the suspected 
pirated material. 


We appreciate your help in protecting our authors, and our ability to bring you 
valuable content. 
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Questions 


You can contact us at questions@packtpub.comif you are having a problem with 
any aspect of the book, and we will do our best to address it. 
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"Continuous effort — not strength or intelligence — is the key to unlocking 
our potential." 


— Winston Churchill 


Jenkins is an open source application written in Java. It is one of the most popular 
continuous integration (CI) tools used to build and test different kinds of projects. 
In this chapter, we will have a quick overview of Jenkins, essential features, and its 
impact on DevOps culture. Before we can start using Jenkins, we need to install it. 
In this chapter, we have provided a step-by-step guide to install Jenkins. Installing 
Jenkins is a very easy task and is different from the OS flavors. 


We will also learn the basic configuration of Jenkins. We will take a quick tour of 
some key sections of the Jenkins UI and plugin installations as well. This chapter 
will also cover the DevOps pipeline and how the rest of the chapters will cover 
implementing it. 


To be precise, we will discuss the following topics in this chapter: 
e Introduction to Jenkins and its features 
e Installation of Jenkins on Windows and the CentOS operating system 
e Ajump-start tour of the Jenkins dashboard 
e How to change configuration settings in Jenkins 


e What is the deployment pipeline 


On your mark, get set, go! 
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Introduction to Jenkins and its features 


Let's first understand what continuous integration is. CI is one of the most popular 
application development practices in recent times. Developers integrate bug fix, 
new feature development, or innovative functionality in code repository. The CI 
tool verifies the integration process with an automated build and automated test 
execution to detect issues with the current source of an application, and provide 
quick feedback. 


CI server runs the 
build and creates 
package 


epository such as 
SVN, Gil 


Cl server runs unit 
and inteare ests 
and Test z 
team 


Jenkins is a simple, extensible, and user-friendly open source tool that provides CI 
services for application development. Jenkins supports SCM tools such as StarTeam, 
Subversion, CVS, Git, AccuRev and so on. Jenkins can build Freestyle, Apache Ant, 
and Apache Maven-based projects. 


The concept of plugins makes Jenkins more attractive, easy to learn, and easy to use. 
There are various categories of plugins available such as Source code management, 
Slave launchers and controllers, Build triggers, Build tools, Build notifies, Build 
reports, other post-build actions, External site/ tool integrations, UI plugins, 
Authentication and user management, Android development, iOS development, 
.NET development, Ruby development, Library plugins, and so on. 


Jenkins defines interfaces or abstract classes that model a facet of a build system. 
Interfaces or abstract classes define an agreement on what needs to be implemented; 
Jenkins uses plugins to extend those implementations. 
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To learn more about all plugins, visit https: //wiki.jenkins-ci. 

org/x/GIAL. 

To learn how to create a new plugin, visit https: //wiki.jenkins- 
ci.org/x/TYAL. 

To download different versions of plugins, visit https: //updates. 

jenkins-ci.org/download/plugins/. 


Features 


Jenkins is one of the most popular CI servers in the market. The reasons for its 
popularity are as follows: 


Easy installation on different operating systems. 

Easy upgrades — Jenkins has very speedy release cycles. 

Simple and easy-to-use user interface. 

Easily extensible with the use of third-party plugins — over 400 plugins. 


Easy to configure the setup environment in the user interface. It is also 
possible to customize the user interface based on likings. 


The master slave architecture supports distributed builds to reduce loads on 
the CI server. 


Jenkins is available with test harness built around JUnit; test results are 
available in graphical and tabular forms. 


Build scheduling based on the cron expression (to know more about cron, 
visit http: //en.wikipedia.org/wiki/Cron). 


Shell and Windows command execution in prebuild steps. 


Notification support related to the build status. 


[3] 


Exploring Jenkins 


Installation of Jenkins on Windows and 
CentOS 


1. Goto https://jenkins-ci.org/. Find the Download Jenkins section on 


the home page of Jenkins's website. 
Download Jenkins 


Release Long-Term Support Release 


Meet Jenkins Java Web Archive (.war) 


Latest and greatest (1.606) 
changelog | past releases | RC 


upgrading from Hudson? 


Or native package 
Use Jenkins EN s 
Windows 


F Ubuntu/Debian 


| @ Red Hat/Fedora/Centos 


X Mac OS X 


Customize Jenkins = Z 
G openSUSE 


1009 


Po 
€ FreeBSD 
Ka OpenBSD 


FES soaristopeni 
24 Solaris/Openindiana 
AG 


Extend Jenkins ` 
«| Gentoo 


2. Download the war file or native packages based on your operating system. 
A Java installation is needed to run Jenkins. 

3. Install Java based on your operating system and set the JAVA_HOME 
environment variable accordingly. 


Installing Jenkins on Windows 


1. Select the native package available for Windows. It will download 
jenkins-1.xxx.zip. In our case, it will download jenkins-1.606.zip. 
Extract it and you will get setup.exe and jenkins-1.606.msi files. 

2. Click on setup.exe and perform the following steps in sequence. On the 
welcome screen, click Next: 
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Jenkins 1.606 Setup 


Wizard 


Back Next 


Welcome to the Jenkins 1.606 Setup 


The Setup Wizard will install Jenkins 1.606 on your computer. 
Click Next to continue or Cancel to exit the Setup Wizard. 


-EE 


Cancel 


3. Select the destination folder and click on Next. 


4. Click on Install to begin installation. Please wait while the Setup Wizard 
installs Jenkins. 


wy 


Jenkins 1.606 Setup 


Installing Jenkins 1.606 


Please wait while the Setup Wizard installs Jenkins 1.606. 


Status: Copying new files 


-EE 


S 


Back Next 


Cancel 
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5. Once the Jenkins installation is completed, click on the Finish button. 


ne Jenkins 1.606 Setup = [I 
ve Completed the Jenkins 1.606 Setup 
Wizard 
Click the Finish button to exit the Setup Wizard. 
Back Finish Cancel 
6. Verify the Jenkins installation on the Windows machine by opening 
URL http://<ip_address>:8080 on the system where you have 


installed Jenkins. 


@ Jenkins 


Jenkins 


ENABLE AUTO REFRESH 


descript 
@ New Item Radd description 


& People Welcome to Jenkins! 
> Build History 

7. Manage Jenkins Please Create new jobs to get started 
A Credentials 


g Jenkins 100K 


Build Queue = 


No builds in the queue. 


Build Executor Status = 


1 Idle 
2 Idle 


Page generated. Jul 9, 2015 11.1245AM RESTAPI Jenkins ver 1606 


Help us localize this 
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Installation of Jenkins on CentOS 


1; 


Use the wget -O /etc/yum.repos.d/jenkins.repo http://pkg. 
jenkins-ci.org/redhat/jenkins.repo command to download repo. 


File Edit View Search Terminal Help 


[root@localhost ~]# sudo wget -0 /etc/yum.repos.d/jenkins.repo http://pkg.jenkin 
s-cl.org/redhat/jenkins.repo 

- -2015-03-28 20:43:22-- http://pkg.jenkins-ci.org/redhat/jenkins. repo 
Resolving pkg. jenkins-ci.org... 199.193.196.24 

Connecting to pkg. jenkins-ci.org|199.193.196.24|:80... connected. 

HTTP request sent, awaiting response... 200 OK 

Length: 75 [text/plain] 

Saving to: “/etc/yum.repos.d/jenkins. repo” 


100% [======================================>) 75 --.-K/s in @s 
2015-03-28 20:43:22 (11.6 MB/s) - “/etc/yum.repos.d/jenkins.repo” saved [75/75] 
[root@localhost ~]# sudo rpm --import http://pkg.jenkins-ci.org/redhat/jenkins-c 


i.org.key 
[root@localhost ~]# Jj 


To install Jenkins on CentOS, download the Jenkins repository definition to 
your local system at /etc/yum.repos.d/ and import the key. 


3. Now, run yum install Jenkins; it will resolve dependencies and prompt 


for installation. 


root@localhost:~ 


File Edit View Search Terminal Help 


[root@localhost ~]# yum install jenkins 
Loaded plugins: fastestmirror, refresh-packagekit, security 
Setting up Install Process 
Loading mirror speeds from cached hostfile 
* base: centosmirror.go4hosting.in 
* extras: centosmirror.go4hosting.in 
* updates: centosmirror.go4hosting.in 


base | 3.7 kB 00:00 
extras | 3.4 kB 00:00 
jenkins | 9518 00:00 
jenkins/primary | 30 kB 00:00 
jenkins 278/278 
updates | 3.4 kB 00:00 


Resolving Dependencies 

--> Running transaction check 

---> Package jenkins.noarch 0:1.606-1.1 will be installed 
--> Finished Dependency Resolution 


Dependencies Resolved 


Package Arch Version 


Installing: 
jenkins noarch 1.606-1.1 jenkins 60 M 


Transaction Summary 


Install 1 Package(s) 


Total download size: 60 M 
Installed size: 66 M 
Is this ok [y/N]: J 
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4. Reply with y and it will download the required package to install Jenkins on 
CentOS. Verify the Jenkins status by issuing the service jenkins status 
command. Initially, it will be stopped. Start Jenkins by executing service 
jenkins start in the terminal. 


root@localhost:~ 


File Edit View Search Terminal Tabs Help 


) 


root@localhost:~ < | root@localhost:~ Xx 


Is this ok [y/N]: y A 
Downloading Packages: 
jenkins-1.606-1.1.noarch. rpm | 60 MB 17:15 
Running rpm check debug 
Running Transaction Test 
Transaction Test Succeeded 
Running Transaction 
Installing : jenkins-1.606-1.1.noarch 1/ 
Verifying : jenkins-1.606-1.1.noarch 1/ 


Installed: 
jenkins.noarch 0:1.606-1.1 


Complete! 

[root 

@loca 

[root@localhost ~]# 

[root@localhost ~]# 

[root@localhost ~]# service jenkins status 

jenkins is stopped 

[root@localhost ~]# service jenkins start 

Starting Jenkins [ OK ] 
[root@localhost ~]# J 


5. Verify the Jenkins installation on the CentOS machine by opening 
the URL http: //<ip_address>:8080 on the system where you 
have installed Jenkins. 


® Jenkins 


Jenkins 


(Wadd description 


~ New Item 


& People Welcome to Jenkins! 
> Build History 
7. Manage Jenkins Please create new jobs to get started 
A Credentials 


Q Jenkins 100K 


Build Queue = 


No builds in the queue 


Build Executor Status i 


1 Idle 
2 Idle 


e ) us localize this page Page generated Jul 9, 2015 11:1646 AM_ RESTAP) Jenkins ver 1.606 
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Installation of Jenkins as a web application 


1. Download Java Web Archive (.war) (latest and greatest (1.606)) from 
http://jenkins-ci.org/. 


2. Copy jenkins.war into your virtual or physical machine. Open Command 
Prompt or a terminal based on the operation system. In our case, we will 
copy it into a directory of a CentOS virtual machine. 


usr - File Browser 


File Edit View Go Bookmarks Tabs Help 


@ Back v $ fa B aa 


fe} Location: | /usr d| Q 100% Q Icon View 


apache-tomcat-7.0. 


Sublime Text 2 


Sublime Text 2.0.2 
x64.tar.bz2 


"jenkins.war" selected (65.8 MB) 
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3. Open Command Prompt and execute the java -jar Jenkins.war 
command. Verify the Jenkins installation on the system by opening the 
http://<ip_address>:8080 URL on the system where you have 


installed Jenkins. 
@ Jenkins [Qscarcn 
jen ENABLE REFRESH 
E New Item Radd ti 
& People Welcome to Jenkins! 
> Build History 


Please Create new jobs to got stariod 


g Manage Jenkins 
AL Credentials 


A 
§3 Jenkins 100K 


Build Queue = 


> builds in the queue 


Build Executor Status ~ 


1 Idle 


2 Idle 


Rh ein us localize his page Page generated 


A jump-start tour of the Jenkins 
dashboard 


1. On the Jenkins dashboard, click on Create new jobs or on New Item to create 
Freestyle- or Maven-based projects for CI. 
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® Jenkins 


E New item 

& People 

> Build History 

g. Manage Jenkins 
Credentials 


Q Jenkins 100K 


Build Queue 


Build Executor Status 


Freestyle project 


Maven project 
Build 


External Job 


This type of jod allows you to record the execution of 


remote machine 


automation system, See the doc 


Multi-configuration project 


Suitable for pre 


multiple environment: 


t. Jenkins takes 


igned so that you can us 


ts that need 


platform 


a 


umentation for more detaits 


a large number of different configurations 


specific builds, ett 


advantage of your POM 


files and drast 


S fu 


ftware build 


@ 


combining any SCM with any 


è Jenkins, eve 


Jenkins as a dashboard of 


your existing 


such as testing or 


2. To verify system properties, visit http: //<ip_address>:8080/systeminfo 
or click on Manage Jenkins, and then click on System Information to get 
environmental information to assist troubleshooting. 


@ Jenkins C 


E New Item 

& People 

TÈ Build History 

7 Manage Jenkins 
Æ Credentials 


g Jenkins 100K 


Build Queue 


No builds in the queue 


Build Executor Status 


System Properties 


Name 
awt. toolkit 
executable-war 
file.er n 
tiie.encoding.pkg 

arato 
hudson diyChunking 
ava.awt graphicsenv 


mt hea 


ava home 


sun, awt. X11 GraphicsEnvironme 


true 


sun print PSPrnterJob 


Value 


REFRESH 
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How to change configuration settings in 
Jenkins 


1. Click on the Manage Jenkins link on the dashboard to configure system, 
security, to manage plugins, slave nodes, credentials, and so on. 


ey Manage Jenkins 

& Peon 

TÈ Build History t New version of Jenkins (1.619) is available for download (changelog) CD efor es tonne 
7 Manage Jenkins 

A Credentials CA 

GQ Jenkins 100K E) 


Build Queue - 


No burkis in the queve 


(updates available) 
Build Executor Status 
1 ide 
2 ide 


2. Click on the Configure System link to configure Java, Ant, Maven, and other 
third-party products' related information. 
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JDK 
bela cae Add JOK 
Ant 
= Add Ant 
Maven 
Ma 
Add Maven 
Maven Project Configuration 
AVEN_O v'\@ 
a Defaut (~/m2/repository) -® 
Z Help make Jenkins be! Ty and cr ti ns proj © 
Jenkins Location 


3. Jenkins uses Groovy as its scripting language. To execute the arbitrary script 
for administration/trouble-shooting/ diagnostics on the Jenkins dashboard, 
go to the Manage Jenkins link on the dashboard, click on Script Console, 
and run print1n (Jenkins.instance.pluginManager.plugins). 


@ Jenkins Cs > 


Build Queve 


No builds in th 


Build Executor Status 


Type in an a 
tput (ìf y 


Script Console 


shooting and diagnostics. Use the ‘printin’ command to see the 


zintin (Jenkins. instance.pluginManager. plugins) 
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4. To verify the system log, go to the Manage Jenkins link on the dashboard 
and click on the System Log link or visit http://localhost :8080/log/all. 


@ Jenkins Qsearcn o 


Jenkins log ENABLE AUTO REFRESH 


p 


EJ Log Recorders © 


t Back to Dashboard 


g- Manage Jenkins 


ie Logger List 
> All Logs 


Name | 


$s 
| All Jenkins Logs 


Add new log recorder 


E New Log Recorder 


Log Levels 


Ei Help us localize this page 


Page generated: Jul 13, 2015 7:45:42 AM RESTAPI Jenkins ver. 1.606 


5. To get more information on third-party libraries — version and license 
information in Jenkins, go to the Manage Jenkins link on the dashboard 
and click on the About Jenkins link. 


Jenkins About Jenkins 


About Jenkins 1.606 


Jenkins is a community-developed open-source continuous integration server. 


Jenkins depends on the following 3rd party libraries 


Jenkins war 


Spring Framework: Web MVC 


Commons BeanUtils 
Bouncy Castle Provider 
oro 


Task Reactor 


dom4 


Groovy 


Maven ID 


org.jenkins-ci.main-jenkins-war: 1.606 


org.springframework:spring- 
webmvec:2.5.6.SEC03 


commons-beanutils:commons-beanutils: 1.8.3 
org.bouncycastle:bcprov-jdk150n:1.47 
oro:0ro:2.0.8 


org.jenkins-ci:task-reactor:1_4 


org.jenkins-ci.dom4j:dom4j:1.6.1-jenkins-4 


org.codehaus.groovy:groovy-all: 1.8.9 


License 
The MIT license 


The Apache Software 
License, Version 2.0 


The Apache Software 
License, Version 2.0 


Bouncy Castle Licence 


The Apache Software 
License, Version 2.0 


MIT License 
BSD License 


The Apache Software 
License, Version 2.0 
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What is the deployment pipeline? 


The application development life cycle is a traditionally lengthy and a manual 
process. In addition, it requires effective collaboration between development and 
operations teams. The deployment pipeline is a demonstration of automation 
involved in the application development life cycle containing the automated build 
execution and test execution, notification to the stakeholder, and deployment 

in different runtime environments. Effectively, the deployment pipeline is a 
combination of CI and continuous delivery, and hence is a part of DevOps 
practices. The following diagram depicts the deployment pipeline process: 


DevOps 


Development Source Code Continuous ce et 
Team Repository Integration z yy 
Deployment 


e SVN ¢ Automated Build e Automate 
* Git * Automated Test deployment 
Execution * Configuration 
* Packaging and Management 
Archiving Tools 


Feedback 


Members of the development team check code into a source code repository. 

CI products such as Jenkins are configured to poll changes from the code repository. 
Changes in the repository are downloaded to the local workspace and Jenkins 
triggers an automated build process, which is assisted by Ant or Maven. Automated 
test execution or unit testing, static code analysis, reporting, and notification of 
successful or failed build process are also part of the CI process. 


Once the build is successful, it can be deployed to different runtime environments 
such as testing, preproduction, production, and so on. Deploying a war file in terms 
of the JEE application is normally the final stage in the deployment pipeline. 


One of the biggest benefits of the deployment pipeline is the faster feedback cycle. 
Identification of issues in the application at early stages and no dependencies on 
manual efforts make this entire end-to-end process more effective. 
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In the next chapters, we will see how Jenkins can be used for implementing CI 
practices in modernizing IT. 


To read more, visit http: //martinfowler.com/bliki/ 


Deployment Pipeline.html and http://www. informit.com/ 
å articles/article.aspx?p=1621865&seqNum=2. 


Self-test questions 
Q1. What is Jenkins? 


1. A continuous integration product 
2. A continuous delivery product 


Q2. What makes Jenkins extensible? 


1. Plugins 


2. Open Source Distribution 
Q3. Which command is used to run the Jenkins installation file in the war format? 


1. java -jar Jenkins .war 


2. java -j Jenkins .war 
Q4. How do we get system information on the Jenkins dashboard? 


1. Visit http://<ip_address>:8080/manage 
2. Visit http://<ip_address>:8080/systeminfo 


Q5. How do we change global settings for configuration on the Jenkins dashboard? 


1. Click on the Manage Jenkins link on the dashboard 
2. Click on the Credentials link on the dashboard 


Q6. What is the deployment pipeline? 


1. Continuous Integration Practices 
2. Continuous Delivery Practices 


3. Demonstration of automation involved in the application development 
life cycle 


4. None of the above 
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Q7. Explain the benefits of the deployment pipeline? 


1. Faster feedback cycle 
2. Identification of issues in an application at early stages 
3. No dependencies on manual efforts 
4. All of the above 
Summary 


Congratulations! We reached the end of this chapter and hence we have Jenkins 
installed on our physical or virtual machine, and you are ready to go to the next 
chapter. Till now, we covered the basics of CI and the introduction to Jenkins and 
its features. We completed the installation of Jenkins on Windows and CentOS 
platforms. We also completed a quick tour of features available in Jenkins's 
dashboard. In addition to this, we discussed the deployment pipeline and its 
importance in CI. 


Now that we are able to use our CI server, Jenkins, we can begin creating a job and 
verify how Jenkins works. 
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Installation and Configuration 
of Code Repository and 
Build Tools 


"Life is really simple, but we insist on making it complicated" 
- Confucius 


We looked at the deployment pipeline in the last chapter in which the source 
code repository and automated build form a significant part. SVN, Git, CVS, and 
StarTeam are some of the popular code repositories that manage changes to code, 
artifacts, or documents, while Ant and Maven are popular build automation tools 
for Java applications. 


This chapter describes in detail how to prepare a runtime environment for life cycle 
management with a Java application and configure it with Jenkins. It will cover how 
to integrate Eclipse and code repositories such as SVN to create a base for continuous 
integration. The following is the list of topics covered in this chapter: 

e Overview of a build in Jenkins and its requirements 

e Installing Java and configuring environment variables 

e SVN installation, configuration, and operations on CentOS and Windows 

e Installing Ant 

e Configuring Ant, Maven, and JDK in Jenkins 

e Integrating Eclipse with code repositories 

e Installing and configuring Git 


e Creating a new build job in Jenkins with Git 
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An overview of a build in Jenkins and its 
requirements 


To explain continuous integration, we are going to use a code repository installed 
on a physical machine or laptop while Jenkins is installed on a virtual machine, 
as suggested in different ways in Chapter 1, Exploring Jenkins. The following figure 
depicts the setup of the runtime environment: 


Jenkins, Java, 


and Ant are SZ oer 
installed on <= LKPACHE ANT> 
CentosvMand | Java ed Jenkins 
Jenkins will 
access Visual SVN 2 
installed on 
Windows. 


Vmware Workstation / 
VirtualBox 


MISUALSVNSERVER 


Physical i ine / Laptop 


We saw in Chapter 1, Exploring Jenkins, that the Manage Jenkins link on the 
dashboard is used to configure the system. Click on the Configure System link to 
configure Java, Ant, Maven, and other third-party product-related information. We 
can create a virtual machine with Virtual box or the VMware workstation. We need 
to install all required software to provide a runtime environment for continuous 
integration. We assume that Java is already installed in the system. 


Installing Java and configuring 
environment variables 


If Java is not already installed in the system then you can install it as follows: 


Find the Java related packages available in CentOS repository and locate the 
appropriate package to install. 
[root@localhost ~]# yum search java 


Loaded plugins: fastestmirror, refresh-packagekit, security 
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ant-javamail.x86 64 : Optional javamail tasks for ant 
eclipse-mylyn-java.x86 64 : Mylyn Bridge: Java Development 


java-1.5.0-gcj.x86 64 : JPackage runtime compatibility layer for GCJ 


java-1.5.0-gcj-devel.x86 64 : JPackage development compatibility layer 
for GCJ 


java-1.5.0-gcj-javadoc.x86 64 : API documentation for libgcj 
java-1.6.0-openjdk.x86 64 : OpenJDK Runtime Environment 
java-1.6.0-openjdk-devel.x86 64 : OpenJDK Development Environment 
java-1.6.0-openjdk-javadoc.x86 64 : OpenJDK API Documentation 
java-1.7.0-openjdk.x86 64 : OpenJDK Runtime Environment 


jcommon-serializer.x86 64 : JFree Java General Serialization Framework 


Install the identified package java-1.7.0-openjdk.x86 64 
[root@localhost ~]# yum install java-1.7.0-openjdk.x86 64 
Loaded plugins: fastestmirror, refresh-packagekit, security 


No such command: in. Please use /usr/bin/yum -help 


Now install Java package available in the local repositories by executing yum 
install command as follows: 

[root@localhost ~]# yum install java-1.7.0-openjdk.x86 64 

Loaded plugins: fastestmirror, refresh-packagekit, security 
Loading mirror speeds from cached hostfile 

Setting up Install Process 

Resolving Dependencies 

--> Running transaction check 


---> Package java-1.7.0-openjdk.x86 64 1:1.7.0.3-2.1.e16.7 will be 
installed 


--> Finished Dependency Resolution 


Dependencies Resolved 
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Install 1 Package (s) 


Total download size: 25 M 
Installed size: 89 M 

Is this ok [y/N]: y 
Downloading Packages: 


java-1.7.0-openjdk-1.7.0.3-2.1.e16.7.x86 64.rpm 
| 25 MB 00:00 


Running rpm check debug 
Running Transaction Test 
Transaction Test Succeeded 
Running Transaction 


Installing : 1:java-1.7.0-openjdk-1.7.0.3-2.1.e16.7.x86 64 
1/1 


Verifying : 1:java-1.7.0-openjdk-1.7.0.3-2.1.e16.7.x86 64 
1/1 


Installed: 
java-1.7.0-openjdk.x86 64 1:1.7.0.3-2.1.e16.7 


Complete! 


Java is installed successfully from the local repository. 


Configure environment variables 


The following are the steps to configure the environment variables: 


Set JAVA_HOME and JRE_HOME variables 
Go to /root 
Press Ctrl + H to list hidden files 


Find .bash_profile and edit it by appending the Java path, as shown in the 
following screenshot: 


PON A 
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jvm - File Browser 


File Edit View Go Bookmarks Tabs Help 


@ Back v 


too aS 


aa 


d| Q 200% Q 


Compact View © 


| A Location: |/usr/ib/jvm 


Placesv 


& root 
Desktop 
k File System 
fŒ Network 

@ Trash 
Documents 
(@ Music 

(@ Pictures 
Videos 
Downloads 


p 


EEE 


RE. 


java-1.5.0-gcj-1.5.0.0 


ava-1.6.0 


ava-1.7.0 


java-1.6.0-openjdk.x86_64 


java-1.7.0-openjdk.x86_64 


java-1.6.0-openjdk-1.6.0.33.x86_64 


java-1.7.0-openjdk-1.7.0.55.x86_64 
java-1.7.0-openjdk-1.7.0.71.x86_64 


[iy 
[ea 


_ by) 
java-openjdk 


a 


a jre-1.5.0-gcj 


18 items, Free space: 6.2 GB 


Installing, configuring, and operating 
SVN on CentOS and Windows 


Install SVN from the local repository on CentOS. 


Installing SVN on CentOS 


To install SVN on a CentOS machine, execute the yum install mod_dav_svn 
subversion command as follows: 


[root@localhost ~]# yum install mod_dav_svn subversion 


Loaded plugins: 


fastestmirror, 


refresh-packagekit, 


Loading mirror speeds from cached hostfile 


Setting up Install Process 


Resolving Dependencies 


--> Running transaction check 


security 


---> Package mod dav_svn.x86_ 64 0:1.6.11-7.e16 will be installed 
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---> Package subversion.x86 64 0:1.6.11-7.e16 will be installed 


--> Processing Dependency: perl(URI) >= 1.17 for package: 
subversion-1.6.11-7.e16.x86 64 


--> Running transaction check 
---> Package perl-URI.noarch 0:1.40-2.e16 will be installed 


--> Finished Dependency Resolution 


Dependencies Resolved 


Installed: 


mod dav_svn.x86 64 0:1.6.11-7.e16 
subversion.x86 64 0:1.6.11-7.e16 


Dependency Installed: 
perl-URI.noarch 0:1.40-2.e16 
Complete! 


[root@localhost ~]# 


Configuring SVN 

Create the password file using the htpasswd command. Initially use the -cm 
arguments. This creates the file and also encrypts the password with MD5. If you 
need to add users, make sure you simply use the -m flag, and not the -c, after the 
initial creation. 

[root@localhost conf.d]# htpasswd -cm /etc/svn-auth-conf yourusername 
New password: 

Re-type new password: 

Adding password for user yourusername 


[root@localhost conf.d]# 


[root@localhost conf.d]# htpasswd -cm /etc/svn-auth-conf mitesh 
New password: 

Re-type new password: 

Adding password for user mitesh 


[root@localhost conf.d]# 
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Now configure SVN in Apache to integrate both. Edit /etc/httpd/conf .d/ 
subversion.conf. The location is what Apache will pass in the URL bar. 


LoadModule dav_svn_module modules/mod_dav_svn.so 


LoadModule authz svn_module modules/mod_authz svn.so 


# 

# Example configuration to enable HTTP access for a directory 

# containing Subversion repositories, "/var/www/svn". Each repository 
# must be both: 

# 

# a) readable and writable by the 'apache' user, and 

# 

# b) labelled with the 'httpd_ sys content t' context if using 

# SELinux 

# 

# 

# To create a new repository "http://localhost/repos/stuff" using 
# this configuration, run as root: 

# 

# # cd /var/www/svn 

# # svnadmin create stuff 

# # chown -R apache.apache stuff 

# # chcon -R -t httpd _sys content _t stuff 

# 


<Location /> 
DAV svn 


SVNParentPath /var/www/svn/ 


# Limit write permission to list of valid users. 
<LimitExcept GET PROPFIND OPTIONS REPORT> 
# Require SSL connection for password protection. 


# SSLRequireSSL 


+ + + + H+ + 
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AuthType Basic 
SVNListParentPath on 
AuthName "Subversion repos" 
AuthUserFile /etc/svn-auth-conf 
Require valid-user 
# </LimitExcept> 


</Location> 


Now all configurations are completed. Let's perform operations on SVN. 


SVN operations 

Create the actual repository to perform SVN operations on the CentOS 

virtual machine. 

[root@localhost ~] cd /var/www/ -- Or wherever you placed your path above 
[root@localhost ~] mkdir svn 

[root@localhost ~] cd svn 

[root@localhost ~] svnadmin create repos 

[root@localhost ~] chown -R apache:apache repos 


[root@localhost ~] service httpd restart 


Import a directory into SVN 


Create a sample folder structure to test SVN operations. Create the mytestproj 
directory with sub-directories named main, configurations, and resources. 
Create sample files in each sub-directory. 


[root@localhost mytestproj]# svn import /tmp/mytestproj/ file:///var/www/ 
svn/repos/mytestproj -m "Initial repository layout for mytestproj" 


Adding /tmp/mytestproj/main 

Adding /tmp/mytestproj/main/mainfilel.cfg 

Adding /tmp/mytestproj/configurations 

Adding /tmp/mytestproj/configurations/testconfl.cfg 
Adding /tmp/mytestproj/resources 

Adding /tmp/mytestproj/resources/testresourcesl.cfg 


Committed revision 1. 


Verify the repository from a web browser: http: //localhost/repos. 
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Check out from SVN 


To check out source code from the repository, perform the following operations: 


T 


Start httpd service. 

[root@localhost testmit]# service httpd restart 
Stopping httpd: 

[ OK ] 


Starting httpd: httpd: Could not reliably determine the server's 
fully qualified domain name, using localhost.localdomain for 
ServerName 


[ OK ] 


Check out the source code. 

[root@localhost testmit]# svn co http://localhost/repos/mytestproj 
Authentication realm: <http://localhost:80> Subversion repos 
Password for 'root': 

Authentication realm: <http://localhost:80> Subversion repos 
Username: mitesh 


Password for 'mitesh' :xxxxxxxxx 


ATTENTION! Your password for authentication realm: 
<http://localhost:80> Subversion repos 


can only be stored to disk unencrypted! You are advised to 
configure your system so that Subversion can store passwords 
encrypted, if possible. See the documentation for details. 


You can avoid future appearances of this warning by setting the value of 
the store-plaintext -passwords option to either yes or no in /root/. 
subversion/servers. 


Store password unencrypted (yes/no)? no 


A mytestproj/main 
A mytestproj/main/mainfilel.cfg 
A mytestproj/configurations 


[27] 


Installation and Configuration of Code Repository and Build Tools 


A mytestproj/configurations/testconfl.cfg 
A mytestproj/options 
A mytestproj/options/testoptsl.cfg 


Checked out revision 1. 


VisualSVN Server on Windows 


1. Download the VisualSVN server from: https: //www.visualsvn.com/ 
server/download/. It allows you to install and manage a fully-functional 
Subversion server with Windows. 


2. Execute VisualSVN-Server-x.x.x-x64.msi and follow the wizard to install 
VisualSVN Server. 


3. Open VisualSVN Server Manager. 


Create a new repository, JenkinsTest. 


File Action View Help 
e 9| 2ml a B| em 


| 


f EJ Repositor== : 
Users | Create New Repository... | 


Revisions 
26 


@ Groups Import Existing Repository... 


Browse 


New 
All Tasks 


View 


Creates new Subversion repository. 
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Select the regular subversion repository and click on Next >. 


6 VisualSVN Server oe = 
File Action View Help 
e9 : 
© Sere cd) 
P Repositories ER =r = 
Users Create New Repository 
(@ Groups 
Repository Type < 
Choose the new repository type. T 
Select the preferred repository type. 


@ Regular FSFS repository 
Create a regular Subversion repository based on the standard FSFS data store. 
© Distributed VDFS repository 
Create a distributed Subversion repository based on the VisualSVN Distributed File 


System. The VDFS repositories act as standard Subversion repositories and allow data 
to be replicated between geographically distributed sites. 


Learn more about available repository types 


< Back Next > Cancel 


6. Provide the Repository Name and click on Next >. 


© VisualSVN Server -5 
File Action View Help 
e| E 
© Visi Serer Loca 
Repositori 
9 3 T — Name Revisions Type 
Gia Users ‘as 26 FSFS 
Gi 7 
& Groups Create New Repository 
Repository Name 
Specify the name for the new repository. T 
Repository Name: 
JenkinsTest 
<Back Next > Cancel 
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7. Select Single-project repository and click on >. 


6 VisualSVN Server - 0 
File Action View Help 
TIE, E: 
© Vu Server Local 
4 |@ Repositories Name Revisions Type | 
‘ta Ms 
© Users ‘wus 26 FSFS 
& Groups Create New Repository 
Repository Structure 


Choose the initial layout for the new repository. 


Select the preferred initial repository structure. 
(Empty repository (recommended option) 
(@ Single-project repository (with the topevel ‘trunk’, branches’ and 'tags' folders) 


You can create the desired repository structure later using the Create Folder or Create Project 
Structure context menu commands for the created repository. 


Learn more about the recommended repository layout 


<Back 


8. 
click on Create. 


Select the Repository Access Permissions based on your requirements and 


File Action View Help 
e» Amae] 


o VisualSVN Server (Local) 
a P Repositories 
Ms 
G@ Users 
(@ Groups 


VisualSVN Server 


Name Revisions Type 
‘a ms 26 FSFS 
Create New Repository 
Repository Access Permissions 


Specify initial access permissions for the new repository. 


Set the kind of permissions you want for the new repository. 
O Nobody has access 
@ All Subversion users have Read / Write access 
© Customize permissions 


Repository access permissions can be adjusted later using the Properies or Manage Security 
context menu commands for the created repository. 


Learn more about access control and permissions 


<Back Create 
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9. Review the created repository details and click on Finish. 


e VisualSVN Server = |e 

File Action View Help 

o VisualSVN Server (Local) JenkinsTest (https:/ svn/JenkinsTest/) 

4 Panga ime 

#3 JenkinsTest branches 
a Create New Repository 
Repository Created Successfully 
Please review the created repository details. T 


Repository Type: FSFS 
Repository Name: JenkinsTest 
Repository URL: https://MS/svn/JenkinsTest 


Configured repository permissions: 
-Everyone (Read / Write) 


Finish Cancel 


10. Verify the newly created repository in VisualSVN Server Manager. 


File Action View Help 
e93| àux aB 
© VisualSVN Server (Local) 
a @ Repositories 
‘tg Ms 
a #9 JenkinsTest 
Œ branches 
G tags 
@ trunk 
Œ Users 
© Groups 


VisualSVN Server = fe 
SE) JenkinsTest | (https://MS/svn/JenkinsTest/) 
Name 
E branches 
Œ tags 
E trunk 
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11. Verify the repository location in the browser, as shown in the 


following screenshot: 


@ dectineTest: / - VisuatSvN. x 


SB hipa 19 168I nenti 


G VISUALSVNSERVER 
JenkinsTest — Revision 1: / 
oO. 

© branches/ 

Dto 

D tuny 


+ 


- ð 


ai -EE E E a O- n: a a 


wep vit Server powered by Subversion 


12. Now install SVN client from: http: //sourceforge.net/projects/ 
tortoisesvn/, to perform SVN operations. 


Let's create a sample JEE project in Eclipse to illustrate SVN and Eclipse integration. 


1. Open Eclipse, go to the File menu and click on Dynamic Web Project. 


Alt+Shift+N > | 


Open File... 


Close 
Close All 


Save 


Save All 


Revert 


Move... 

Rename... 

Refresh 

Convert Line Delimiters To 


Print... 


Switch Workspace 
Restart 


Import... 


Properties 


1 sonar-project.properties [AntExample1] 
2 checkstyle_checks.xml [AntExample1] 
3 build.xml [AntExample1] 

4 UserServicelmpl.java [AntExample1/...] 


Exit 


Ctrl+W 
Ctrl+Shift+W 


Ctrl+S 


Ctrl+Shift+S 


Alt+Enter 


JPA Project 
Enterprise Application Project 


Dynamic Web Project 


EJB Project 

Connector Project 
Application Client Project 
Static Web Project 
Project... 


Servlet 

Session Bean (EJB 3.x) 
Message-Driven Bean (EJB 3.x) 
Entity 

Web Service 

Folder 

File 

Example... 


Other... 
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It will open a dialog box to create a New Dynamic Web Project. 


Dynamic Web Project a 
Create a standalone Dynamic Web project or add it to a new or existing Enterprise Application. @ 


Project name: AntExample1 


Project location 
[¥] Use default location 


ocation; C:\Users\Mltesh\workspace\AntExample1 Browse... 


Target runtime 


J2EE Runtime Library New Runtime... 


Dynamic web module version 
25 


Configuration 
Default Configuration for J2EE Runtime Library v Modify... 


A good starting point for working with J2EE Runtime Library runtime. Additional facets can later be 
installed to add new functionality to the project. 


EAR membership 
C] Add project to an EAR 


EAR project name; AntExamplelEAR vi | New Project... 
Working sets 
[C] Add project to working sets 


Working sets: 
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3. Create the source files and a build file for a simple project. 


5 


file Eda Navigate Search Project Run Window Help 


r37 & $-~O-Q~ 
[D Project Explorer 33 "Oo 
Sle * 
 Antiamplet 


Ts Deployment Descriptor Antixample! 
A HUGS Web Services 

24 Javo Resources: sec 

BA JavaScript Resources 

© build 

S WebComtent 

E buildam 

© checkstyle checksamn! 

LÀ sonar project properties 


< 


G-0- 964- Psat 


<project name="AntExamplel" default="war"> 


@ 2 Hr tivs 


checkstyle_checksaml D sonar project. properties 


or 


<path id="compile.classpath"> 


<fileset dir="WebContent/WEB-INF/lib"> 


<include name= 
</fileset> 
</path> 


<target name="init"> 


* jar" /> 


<mkdir dir="build/classes"/> 


<mkdir dir="dist" 
</target> 


/> 


<target name="compile" depends="init" > 


<javac destdir="build/classea" debug="true" 


srcedir="src 


<classpath refid="compile.classpath"/> 


</javac> 
</target> 


<target name="war" depends="compile"> 


(Š. Markers (Tl Properties #5 Servers YË Data Source Explorer fy Snippets 3) SVN Repositories 


C) henps192.168.1.12/sveVientons Test 


G branches 
5 ug 
D monk 


Writabie 


#) Antiamplet 
«i> compileclasspath 
® m 
® compile 
A wor deraut) 
clean 
@ checkstyle 


4. Goto Application Directory, right-click on it, select TortoiseSVN, and select 
Import from the sub-menu. 


Share 


View 


aĝ Homegroup 


IE This PC 
‘ik Desktop 
B Documents 
B Downloads 
I Music 
[È Pictures 
\B Videos 
Äi Local Disk (C:) 
i New Volume (D:) 
& New Volume (E:) 
RECOVERY (F:) 
Ñ CD Drive (H:) OFFICI 


Ge Network 


Add to VLC media player's Playlist 
Open as Notebook in OneNote 
Play with VLC media player 


Share with 


SVN Checkout... 


© ~ T Ji» ThisPC > Local Disk(C:) » Users > Mitesh > workspace 
Ai Name € Date modified Type Size 
E Desktop p „metadata 6/30/2015 11:08 PM_ File folder 
T$ Downloads AntExampleT “folder 
E Recent places re $ A 
ta SkyDrive Open in new window 


TortoiseSVN 


> eR, Repo-browser 


Include in library 

Pin to Start 

Norton Internet Security 
Add to archive... 

Add to "AntExample1.rar" 
Compress and email... 


Compress to "AntExamplel.rar" and email 


Send to 

Cut 

Copy 

Create shortcut 


Delete 
Rename 


Properties 


>| Sy Export... 


(P Create repository here 
Al Import... 


> Settings 
% Help 
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5. Enter the repository URL and click on OK. 


6. It will add all files from the application to SVN, as shown in the 
following screenshot. 


i 


Path 

Import C:\Users\MItesh \workspace \AntExample 1 to https://192. 168. 1. 12/svn/JenkinsTest/trunk/AntExample 1 

C:\Users \MItesh \workspace \AntExample 1\,dasspath 

C: \Users \MItesh \workspace \AntExample 1\,project 

C:\Users \MItesh \workspace \AntExample 1\,settings 

C:\Users \MItesh \workspace \AntExample 1\,settings\,jsdtscope 

C:\Users \MItesh \workspace \AntExample 1\,settings \org. eclipse. jdt.core.prefs 

C:\Users \MItesh \workspace \AntExample 1\,settings \org. eclipse. wst.common.component 

C:\Users \MItesh \workspace \AntExample 1\,settings\org.eclipse. wst.common. project. facet.core.xml 

C:\Users\MItesh \workspace \AntExample 1\,settings \org. eclipse. wst.jsdt.ui.superType.container 

C:\Users \MItesh \workspace \AntExample 1\,settings \org. eclipse. wst.jsdt.ui.superType.name 

C;\Users \MItesh \workspace \AntExample 1\WebContent 

C:\Users\MItesh \workspace \AntExample 1\WebContent\META-INF 

C:\Users \MItesh \workspace \AntExample 1\WebContent\META-INF\MANIFEST.MF 

C:\Users \MItesh \workspace \AntExample 1\WebContent\WEB-INF 

C:\Users \MItesh \workspace \AntExample 1\WebContent\WEB-INF \dispatcher-servlet.xml 

C:\Users\MItesh \workspace \AntExample 1\WebContent\WEB-INF\jsp 

C:\Users \MItesh \workspace \AntExample 1\WebContent\WEB-INF \jsp \userForm.jsp 

C: \Users \MItesh \workspace \AntExample 1\WebContent\WEB-INF \jsp \userSuccess.jsp 

C:\Users\MItesh \workspace \AntExample 1\WebContent\WEB-INF \ib 

C:\Users\MItesh \workspace \AntExample 1\WebContent\WEB-INF \ib \antir-runtime-3.0.jar application/octet-stream 

C:\Users\MItesh \workspace \AntExample 1\WebContent\WEB-INF \lib \checkstyle-6.6-all.jar application/octet-stream 

C: \Users \MItesh \workspace \AntExample 1\WebContent\WEB-INF \jib \checkstyle-6.6.jar application/octet-stream 

C:\Users\MItesh \workspace \AntExample 1\WebContent\WEB-INF \lib \commons4ogging-1.0.4.jar application/octet-stream 

C:\Users \MItesh \workspace \AntExample 1\WebContent\WEB-INF \ib \org. springframework.asm-3.0.0.M3.jar application/octet-stream wv 
> 


UNEREN 
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7. Verify the import by visiting the SVN repository in a browser as shown: 


Hele 
6 VISUALSVNSERVER 


JenkinsTest — Revision 2: /trunk 
So. 
© Antexamplet/ 


Integrating Eclipse with code repositories 
1. Open Eclipse IDE, go to the Help menu and click on Install New Software. 


2. Add the repository by adding this URL: http: //subclipse.tigris.org/ 
update_1.10.x, then select all packages and click on Next >. 


© Install - a | x | 


Available Software 
Check the items that you wish to install. 


Work with: | SVN - http://subclipse.tigris.org/update_1.10.x v Add... 
Find more software by working with the "Available Software Sites" preferences. 


type filter text 


Name Version A 
a [v] 000 Subclipse 
v) “i CollabNet Merge Client 4.1.0 
[¥] Ge Subclipse (Required) 1.10.9 
[¥] Ge Subclipse Integration for Mylyn 3.x (Optional) 3.0.0 
7] {iii Subversion Client Adapter (Required) 1.103 
[V] Ge Subversion JavaHL Native Library Adapter 1.8.13 
7) Ga Subversion Revision Graph 14 
a [7] 000 SVNKit 
[7] Gi JNA Library 4.1.0.v20140626_1915 
7| Git SVNKit Client Adapter (Not required) 189 v 
Select All Deselect All 9 items selected 
Details 
[¥] Show only the latest versions of available software [C] Hide items that are already installed 
[¥] Group items by category What is already installed? 


Cl Show only software applicable to target environment 


K 


Contact all update sites during install to find required software 


@ E Next > F Cancel 


3. Review the items to be installed and the Review Licenses in the wizard. 
Accept the terms of agreement and click on Finish. 


4. Restart Eclipse. Go to the Window menu, select Show View, click on Other, 
and find the SVN and SVN repositories. 


5. Inthe SVN repositories area, right-click and select New; select Repository 
Location... from the sub-menu. 
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File Edit Navigate Search Project Run Window Help 
‘Ores %~O-Q~ Br G- @GV~'0'8 m [GS ava EE | 
: Bly rly ov 

(T Project Explorer 23 ~ = SASN Reposts 7 >$] 


vv 


imaa] 


gls 


2 AntExamplel 
Èa Deployment Descriptor: AntExample1 
A JAX-WS Web Services 
25 Java Resources: src 
BA JavaScript Resources 
© build 
& WebContent 
WB) build.xml 
|X) checkstyle_checksxml 
=| sonar-project.properties 


= 6) 


ek Ee RBS 


6. Addanew SVN Repository in Eclipse with this URL: 
https://<Ip address/ localhost / hostname>/svn/JenkinsTest/. 


7. Click on Finish. 


Add a new SYN Repository 
Add a new SVN Repository to the SVN Repositories view 


Location 

Url: | https: svn/JenkinsTest/ 
Tired of typing in long URL's? Your repository provider might provide a plug-in that 
would allow you to select your repository from a list. 
Click here to see the list of available providers. 


y] 


` 


Free Subversion Repository Hosting from CloudForge 
Sign-up for CloudForge and get free Subversion repository hosting 
with unlimited users and repositories, plus free agile tracker tools. 


cancel | 
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8. Verify the SVN repository. 


(2) x 
Hle Edit Nevigate Search Project Bum Window Help 
rte %-O-Q&- Geo- weve 9 2 ELE- LACR ci | vie 
dy Project Explorer 1 ) E buildami $3 X checkstyle checks xml I| sonur-project.properties =) Be Our t ORCI 
= %| oe 7| i " n a8 *& BRR 
D AetEsaenpte! <project name="AntExamplel" default="war"> mi) Aca Exenple! 
dy Deployment Descriptor: Antfxamplel compile.classpath 
AÈ JAXAWS Web Services ® init 
ÈB Java Resources: src <path id="compile.cle ® compile 
BA JavaScript Resources <fileset dir="W EB-IN ib"> Q war (detoult} 
© burs F a why ® clean 
<inc name="* > 
> WebContent <include name ejar"/> D checkstyle 
JB) bud </fileset> 
È checkstyle, checksarl </path> 
sonar: propect.propedies 
<target name="init"> 
<mkdir dir="build/classes"/> 
<mkdir dir="dist" /> 
</target> 
<target name="compile" depends="init" > 
<javac destdir="build/clas " debug="true" sredir="sre 
<classpath refid="comnile.classmath"/> s 
< > 
ih Markers Data Source Explorer `i Snippets TU) SVN Repositories 1i è B7 
210 Pet a 
O> branches 
D tags 
a & trunk 
4 & Anttamplet 
D WebContent 
D we 
E) buida a 
X) checkstyle checksaml 4 
| iceneitd v 


Try to integrate SVN, installed on CentOS, with Eclipse IDẸ, as practice. 


Installing and configuring Ant 


1. Download the Ant distribution from: https: //ant .apache.org/ 
bindownload. cgi and unzip it. 


2. Set the ANT_HOME and JAVA_HOME environment variables. 
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root@localhost:~/git/development/AntExample1 
File Edit View Search Terminal Tabs Help 


root@localhost:~/git/development/AntExa... J€ ] root@localhost:/usr x 


[root@localhost Desktop]# git --version 
git version 1.7.1 
[root@localhost Desktop]# git config --global user.name "Mitesh" 
[root@localhost Desktop]# git config --global user.email {(==———“Jegmail.co 
m" 
[root@localhost Desktop]# git config --list 
user.name=Mitesh 
user.email gmail.com 
core. repositoryformatversion=0 
core. filemode=true 
core. bare=false 
core. Logallrefupdates=true 
[root@localhost Desktop]# mkdir -p ~/git/development ; cd ~/git/development 
[root@localhost development]# cd AntExamplel/ 
[root@localhost AntExamplel]# git init 
Initialized empty Git repository in /root/git/development/AntExamplel1/.git/ 
[root@localhost AntExamplel]# git add . 
[root@localhost AntExample1]# 
[v] 


There is an option available in Jenkins to install Ant or Maven automatically. We will 
study this in the Configuring Ant, Maven, and JDK in Jenkins section. 


Installing Maven 


Download the Maven binary ZIP file from https ://maven.apache.org/download. 
cgi and extract it to the local system where Jenkins is installed. 


Eo Aa PONEN 1 © C |(O instal win on sonos Jeene osno Pp- 


“Apache Maven Project M -i 


Apache Maven Last Published: 2015-07-08 


Apache Maven 3.3.3 


Welcome 
p and recommended version for all users 
License 
Install 
Configure Other mirrors: http://www carta comlapache: || “Change 
Run 
IDE integration i 
eg System Requirements 
What is Maven? Java Development Maven 3.3 requires JDK 1.7 or above to execute - t still allows you to build against 1.3 and other JDK versions by Using Toolchains 
Kit (JDK) 
Features 
FAQ Memory No minimum requirement 
Support and Training p i 
Disk Approximately 10M8 is 1 he Maven installato: n addition to that, addi pace wil be used for your local Maven 
repository. The siz ory will vary dep n usagé but expect at lea: 
Maven Plugins Operating System No minimum requirement. Start up scripts are included as shell scripts and Windows batch files 
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Configuring Ant, Maven, and JDK in 
Jenkins 


1. Open the Jenkins dashboard in your browser with this URL: http: //<ip_ 
address>: 8080/configure. Go to the Manage Jenkins section and click on 


Configure System. 
2. Configure Java, based on the installation shown in the following screenshot: 


JDK installations JDK 


Name javat.7 


JAVA_HOME | jusrilibyivmfjava-1.7.0-openjdk-1.7.0.71.x86_64 


C Install automatically 


Delete JDK 


JDK 


Name java 8 


JAVA_HOME  joptjidk1.8.0_45 


C1 Install automatically 
Delete JDK 


Add JDK 
List of JDK installations on this system 
Git 
Git installations 
Git 
Mame Default 


Path to Git executable git @ 
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3. Configure or install Ant automatically on the same page. Configure Maven 


as well. 
Ant 
Ant installations Ant 
Name Ant1.9.4 
A a 
Wv] Install automatically @ 
Install from Apache 
Version | 1.9.4 v 
Delete Installer 
Add Installer v 
Delete Ant 
Add Ant 
List of Ant installations on this system 
Maven 
Maven installations Maven 


Name Maven1.3 


MAVEN_HOME /usr/lib/apache-maven-3.2.1 


© 


C Install automatically K 


Installing and configuring Git 


Git is a free and open source distributed version control system. In this section, 
we will try to install and configure Git. 


1. Open the terminal in the CentOS-based system and execute the command 
yum install git in the terminal. 


2. Once it is successfully installed, verify the version with the command 
git --version. 


3. Provide information about the user with the git config command so that 
commit messages will be generated with the correct information attached. 
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4. Provide the name and e-mail address to embed into commits. 


5. To create a workspace environment, create a directory called git in the home 
directory and then create a subdirectory inside of that called development. 


Use mkdir -p ~/git/development ; cd ~/git/development in 
the terminal. 
Copy the AntExample1 directory into the development folder. 


Convert an existing project into a workspace environment by using the 
git init command. 


8. Once the repository is initialized, add files and folders. 


root@localhost:~/git/development/AntExamplel1 
File Edit View Search Terminal Tabs Help 


root@localhost:~/git/development/AntExa... >< | root@localhost:/usr 


[root@localhost Desktop]# git --version 

git version 1.7.1 

[root@localhost Desktop]# git config --global user.name "Mitesh" 
[root@localhost Desktop]# git config --global user.email {({==—=“Jegmail.co 
m" 

[root@localhost Desktop]# git config --list 

user.name=Mitesh 

user.email gmail.com 

core. repositoryformatversion=0 

core. filemode=true 

core.bare=false 

core. Logallrefupdates=true 

[root@localhost Desktop]# mkdir -p ~/git/development ; cd ~/git/development 
[root@localhost development]# cd AntExamplel/ 

[root@localhost AntExamplel]# git init 

Initialized empty Git repository in /root/git/development/AntExamplel/.git/ 
[root@localhost AntExamplel]# git add . 

[root@localhost AntExamplel]# 
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9. Commit by executing git commit -m "Initial Commit" -a. 


root@localhost:~/git/development/AntExamplel1 


File Edit View Search Terminal Tabs Help 


root@localhost:~/git/development/AntExa... X€ root@localhost:/usr Xx 


create mode 100755 WebContent/WEB-INF/lib/checkstyle-6.6-all.jar acy 
create mode 100755 WebContent/WEB-INF/lLib/checkstyle-6.6.jar 

create mode 100755 WebContent/WEB-INF/1lib/commons-logging-1.0.4.jar 

create mode 100755 WebContent/WEB-INF/1ib/org.springframework.asm-3.0.0.M3.jar 
create mode 100755 WebContent/WEB-INF/lLib/org.springframework.beans-3.0.0.M3.ja 
r 

create mode 100755 WebContent/WEB-INF/lib/org.springframework.context-3.0.0.M3. 
jar 

create mode 100755 WebContent/WEB-INF/lib/org.springframework.context.support-3 
.0.0.M3.jar 

create mode 100755 WebContent/WEB-INF/lib/org.springframework.core-3.0.0.M3.jar 
create mode 100755 WebContent/WEB-INF/lib/org.springframework.expression-3.0.0. 
M3.jar 

create mode 100755 WebContent/WEB-INF/lib/org.springframework.web-3.0.0.M3.jar 
create mode 100755 WebContent/WEB-INF/lib/org.springframework.web.servlet-3.0.0 
.M3.jar 

create mode 100755 WebContent/WEB-INF/web.xml 

create mode 100755 WebContent/redirect.jsp 

create mode 100755 build.xml 

create mode 100755 checkstyle _checks.xml 


create mode 100755 license.txt [x 
10. Verify the Git repository 
} Index of file:///root/gi... x \ {q 
€ = @file:///root/git/development/ v e| | By Google Ar + A = 

Index of file:///root/git/development/ 

# Up to higher level directory Show hidden objects 
Name Size Last Modified 
git 02/23/2015 10:33:35 AM 
@ antexample1 06/30/2015 11:53:45 AM 
[P HEAD 1KB 02/23/2015 11:22:31 AM 
@ branches 02/23/2015 11:22:31 AM 
[E config 1KB 02/23/2015 11:22:31 AM 
[B description 1KB 02/23/2015 11:22:31 AM 
hooks 02/23/2015 11:22:31 AM 
info 02/23/2015 11:22:31 AM 
@objects 02/23/2015 11:22:31 AM 
@refs 02/23/2015 11:22:31 AM 

g 
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11. Verify the project in the Git repository. 


} Index of file:///root/gi... x \ + 


€ file:///root/git/development/AntExample1/ w B~ 


Index of file:///root/git/development/AntExample1/ 


t Up to higher level directory 


Name Size 

B git 

@ webContent 

6) build.xml 2 KB 

6) checkstyle_checks.xml 11 KB 
license.txt 11 KB 
sonar-project.properties 1 KB 

@src 


are t+ A 


YI Show hidden objects 


Last Modified 


06/30/2015 
05/20/2015 
05/22/2015 
04/25/2015 
05/20/2015 
05/20/2015 
05/20/2015 


11:54:30 AM 
01:26:40 AM 
08:19:49 AM 
08:45:14 PM 
01:26:39 AM 
03:12:22 AM 
01:26:39 AM 


Creating a new build job in Jenkins 


with Git 
1. 


On the Jenkins dashboard, click on Manage Jenkins and select Manage 
Plugins. Click on the Available tab and write github plugin in the 


search box. 


2. Click the checkbox and click on the button, Download now and install 


after restart. 


3. Restart Jenkins. 


CS ies tog ow 
È ba a giru 
gA Manage Jenkin Installed 
Enablod Name | Version Previously installed version Pinned Uninstall 
A - Downgrade to 1.67 Urenstall 


F 


Uninstall 
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4. Create a new Freestyle project. Provide Item name and click on OK. 


@ Jenkins Qsercn 


@& New Item tem name  AntExampleGit 


& People 


Freestyle project 


T Build History our project. combining any SCM with any build system, and this can be 
Project Retationship Maven project 
aZ, Check Fi jerpr Buik a maven project. Jenkins takes advantage of your POM fies and drastkally reduces the configuratior 
Build Flow 
g Manage Jenkins A Build Flow can manage job c alized way hestration 
polluting the jobs with var nan 
A Credentials 
o External Jod 
Disk usage This type of job 2 cess run outside Jenkins, even on a remote machine. This is designed 
p $0 that you can use sting automation system See the documentation for more d 
Q Jerkins 100K 
Multi-configuration project 
Suilable for projects that need a large number of different configurations, such as testing on multiple environments, platform 
Build Queue =- specme builds, et 
No builds in the queue Copy existing Item 
py fron 
Build Executor Status 
= master 


MWindowsNode (offline) 


5. Configure Git in the Source Code Management section. 


Source Code Management 


) None 
) CVS 
D CVS Projectset 
® Git 
Repositories = 
P Repository URL file:/liroot'git'development/AntExample1/ (2) 
Credentials Saas = PE 
>) 
Advanced... 
Add Repository Delete Repository 
Branches to build Branch Specifier (blank for ‘any’) master © 
Add Branch Delete Branch 
Repository browser (Auto) Jo 
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6. Add the Invoke Ant build step by clicking on Add build step. 


Build 


Invoke Ant 
Ant Version Default 


Targets war 


Add build step v 
Post-build Actions 
Publish combined analysis results 


Checkstyle warnings [%4] 


FindBugs warnings [X] 


Compiler warnings [¥] 


Apply 


Advanced... 


7. Execute the build. 


@ Jenkins 


Jenkir AntExampleGit #2 


@ Back to Project 
Status 

= Changes 

E Console Output 

TÈ Edit Build Information 

© Delete Build 
Environment Variables 

® Git Build Data 

= No Tags 

@ Previous Build 


@ Next Build 


h Help us localize this page 


D Started by user Mitesh 
t 


(=) Build #2 (Jun 30, 2015 12:03:05 Shanto 10 00y 


te 
nok 6 8 sec on master 


PM) 


(Badd description 


No changes 


5d9cabc5e2 1ba3266d940680907607330 


Page generated: Jul 11, 20157:2327 AM REST APY 
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8. Click on Console Output to see the progress of the build. 


@ Jenkins C 


S BERIS Prp QJ Console Output 

Status 

> Changes 

E Console Output 
View as plain text ning repository fil i Ji jevelopme AntExamplel 


> Edit Build Information 


© Delete Build 


Environment Variables 3 t £ te.ori zit cgit c/aAncexomplei/ ¢ 
@ Git Build Data jit nf remot rigin. fetch t P S| EO oy re 
= No Tags jit : f t J f t t selog t/ANntEX 3 


@ Previous Build 


@ Next Build 


Executed Ant Targets 


9. Once the build has succeeded, verify Workspace in the build job. 


® Jenkins C 


f Back to Dashboard Workspace of AntExampleGit on master 
Status 
> Changes $ 

E Workspace 
y Wipe Out Current Workspace 


É) Build Now 


© Delete Project 


g Configure 


Bulld History trend = Sa 
og 
oz 
on 


E RSS tor at EJ RSS for t 


10. Done! 
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Self-test questions 


Q1. Where to set the JAVA_HOME and JRE_HOME environment variables? 


/root/ .bash_profile 
/root/ .env_profile 


/root/ .bash variables 


Pen 


/root/ .env_variables 
Q2. Which are valid SVN operations? 


1. svn import /tmp/mytestproj/ 
2. svn co http://localhost/repos/mytestproj 
3. Both the above 


Q3. Where do you configure Java and Ant in Jenkins? 


1. Go to the Manage Jenkins section and click on Configure System 


2. Go to the Manage Jenkins section and click on Global Configuration 


Summary 


Hooray! We have reached the end of this chapter. We have covered how to prepare 
an environment for continuous integration by setting up a local CentOS repository, 
installing code repositories such as SVN on CentOS and Windows, and build tool 
Ant. We have also seen detailed instructions on how to configure repositories and 
build tools in Jenkins. Finally, we have covered how to integrate the Integrated 
Development Environment with code repositories so that efficient development 
and ease of commit operations can take place to facilitate the deployment 

pipeline process. 
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"The barrier to change is not too little caring; it is too much complexity" 
- Bill Gates 


We have seen how to set up an environment to use Jenkins for continuous 
integration, and we have also configured build tools in Jenkins. The integration of 
Eclipse with SVN will help developers to easily perform operations on repositories. 


Now we are ready to create our first build job for continuous integration. 

This chapter describes in detail how to create and configure build jobs for Java 
applications using build tools such as Ant and Maven; how to run build jobs, unit 
test cases. It covers all aspects of running a build to create a distribution file or war 
file for deployment, as well as a Dashboard View plugin to provide a customized 
display of build jobs and test results based on preferences. The following are the 
main points which are covered in this chapter: 


e Creating and configuring a build job for a Java application with Ant 
e Creating and configuring a build job for a Java application with Maven 


e Build execution with test cases 
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Creating and configuring a build job fora 
Java application with Ant 


Before creating and configuring a build job for a Java application, we will install a 
Dashboard View plugin to better manage builds, and display the results of builds 
and tests. We have already seen how to create a basic job in Chapter 2, Installation 
and Configuration of Code Repository and Build Tools. 


Dashboard View Plugin 


This plugin presents a new view that provides a portal-like view for Jenkins build 
jobs. Download it from https: //wiki.jenkins-ci.org/display/JENKINS/ 
Dashboard+View. It is good for showing results and trends. In addition, it also 
allows the user to arrange display items in an effective manner. On the Jenkins 
dashboard, go to the Manage Jenkins link and click on Manage Plugins and install 
the Dashboard View plugin. Verify the installation by clicking on the Installed tab. 


Jenkins Plugin Manager 


t Back to Dashboard 
g- Manage Jenkins 
Filter: Dashboard View 


Installed 


Enabled Name | Version Previously installed version Pinned Uninstall 
Dashboard View 


[x] 2.9.4 Downgrade to 2.9.4 Uninstall 
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On the Jenkins dashboard, click on the plus button to create a new view. Provide a 
View name and select the type of view; in our case Dashboard, then click on OK. 


@ Jenkins 1h 20h 


@ New ltem View name MyView 
& People Build Monitor View 
Shows a highly visible status of selecte Ideal as an Extreme Feedback Device to be 


TÈ Build Hi story 


Project Relationship Build Pipeline View 


omplete pipeline of jobs that a version propagates 


ê Check File Fingerprint 


g Manage Jenkins Dashboard 


A Credentials 


Customizable view that contains various portiets containing information about your job(s) 


Delivery Pipeline View 
@ Disk usage ae me 


A 
Sg Jenkins 100K Deployment Dashboard 
View for Deployment Dashboard. This dashboard integrates with an artifact repo: 
availa! rifactid. It also integrates with your EC2 envir ts and gets 
Build Queue = the current status of your ir 
No builds in the queue 
Build Executor Status - 


Provide a Name and select Jobs that need to be included in the view, as shown in the 
following screenshot: 


®@ Jenkins CL © 


> 
2 
Edit View 
r ® 
a ' Ò 
a 
añ Job Filter 
Build Qu sacs °@ 
+ 
Build Executor Status 
® 
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In the View configuration, click on Add Dashboard Portlet to right column, and 
select Test Statistics Grid. Add Test Statistics Chart. This will display test results 
in the form of statistics and chart representations of test results. 


Portlets in the right c 


Test Statistics Chart 


Test Statistics Chart 


Add Dashboard Portlet to right coh - 


Portlets at the bonom of the page 


Creating and configuring a build job for a 
Java application 


Click on New Item on the dashboard to create a new build for a Java application 
which uses Ant as a build tool. Enter Item name, and select Freestyle project. 
Click OK. 


tem name 


E New Item . AntExampie1 


& People ® Freestyle project 


™ Build History 


Edit View Maven project 
Build a maven project. Jenkins takes advantage of your POM files and drastically reduces the 
View : 
© Delete View configuration 
Project Relationship Build Flow 


ty, in a centralz 


| manage job orchestration as a de 


Juki Fk 
#= Check File Fingerprint A Build f 


‘ation and without polluting the j S plugins to h 


vam cha 

7 Manage Jenkins eam chain 

A d External Job 
Credentials 


HaTe 7 
Disk usage automation system 
g Jenkins 100K Multi-configuration project 


Build Queue e 
OK 


No builds in the queue 
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It will open the configuration for a new build job. In Source Code Management, 
select Subversion. Provide the Repository URL and Credentials. In Chapter 2, 
Installation and Configuration of Code Repository and Build Tools, we installed 
Subversion and also added the source code to SVN. 


Provide the URL you use in your browser to access the source code repository. 


Source Code Management 


D None 

) CVS 

) CVS Projectset 
’ Git 

® Subversion 
Modules 


Raposminy URE https://192.168.1.12/svn/MS/AntExample1 © 


Credentials mitesh51/****** (SVN) v| @e Add 


Local module directory 


Repository depth infinity {v 
Ignore externals v 
Add module... 
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If Credentials are not available in the box, click on the Add button. Provide Scope, 
Username, Password, and Description, and click on Add to make it available on the 
list box available in the build job configuration. Scope determines where credentials 
can be used. For example system scope restricts credential usage to the object with 
which the credential is associated. It provides better confidentiality than global 
scope. Global scope credentials are available to the object with which the credential 
is associated and all objects that are children of that object. 


@= Add Credentials 


a Username with password v 
Scope Global (Jenkins, nodes, items, all child items, etc) v (2) 
Username miki © 
Password | sess... © 
Description © 

Advanced... 
Add Cancel 


In the build job configuration, go to the Build Triggers section and select the Poll 
SCM radio button. Provide the schedule detail in the * * * * * form, as shown in the 
following figure. It will poll the repository every minute to verify changes committed 
into the repository by developers. 
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Build Triggers 
O Build after other projects are built (2) 
O Build periodically @ 


C Build when a change is pushed to GitHub 


M Poll SCM (2) 
Schedule EVNEN 
© 


A Do you really mean “every minute" when you say "* * * * *"? Perhaps 
you meant "H * * * *" to poll once per hour 


Ignore post-commit hooks [] (2) 


The Schedule field follows cron syntax, MINUTE HOUR Day Of the Month 
MONTH Day Of the Week. 


For example, H * * * * to poll once per hour, H/15 * * * * to poll every fifteen minutes. 


Once Build Triggers and Source Code Management configurations are completed, 
we need to provide build tool-related details, so Jenkins can use them to execute once 
the build is triggered. Click on the Add build step and select Invoke Ant. From the 
drop-down menu, select Ant, configured in Chapter 2, Installation and Configuration 

of Code Repository and Build Tools and provide Targets with the name you want to 
execute from the build. 


Build 
Invoke Ant © 
Ant Version Antt.9.4 7 
Targets WAR v © 
Advanced... 


Add build step v 
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Click on the Apply and Save buttons to finalize the configuration. Click on the Build 
Now button on the Jenkins dashboard. It will check out all the latest available code in 
the source code repository against the local workspace on the machine where Jenkins 
is installed, as shown in the following figure. In the build history section of a specific 
job, click on build number, and then click on Console Output. 


®@ Jenkins Ss 2 


G hae (Ð Console Output 


Status 
=) Changes 
E Console Output 
View as plain text 
T> Edit Build Information 
© Delete Build 
Environment Variables 
=| Tag this build 


@ Previous Build 


uted Ant Targets 


Once the checkout process is completed, the build file execution, based on the 
targets, will start, and the build execution will be successful if all dependencies and 
files required for the build execution are available in the local workspace, as shown 
in the following figure: 
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Buildfile: /root/.jenkins/jobs/AntExamplel1/workspace/build.xml 
init: 
[mkdir] Created dir: /root/.jenkins/jobs/AntExample1/workspace/dist 


compile: 

[javac] /root/.jenkins/jobs/AntExamplel1/workspace/build.xml:16: warning: 
‘includeantruntime' was not set, defaulting to build.sysclasspath=last; set to 
false for repeatable builds 


/build/classes 

[javac] Note: /root/.jenkins/jobs/AntExamplel1/workspace/src/com/vaannila 
/web/UserController.java uses or overrides a deprecated API. 

[javac] Note: Recompile with -Xlint:deprecation for details. 


war: 
[war] Building war: /root/.jenkins/jobs/AntExample1/workspace 
/dist/AntExample.war 


BUILD SUCCESSFUL 

Total time: 5 seconds 

Started calculate disk usage of build 

Finished Calculation of disk usage of build in 0 seconds 
Started calculate disk usage of workspace 

Finished Calculation of disk usage of workspace in 0 seconds 
Finished: SUCCESS 


[mkdir] Created dir: /root/.jenkins/jobs/AntExamplel/workspace/build/classes 


[javac] Compiling 4 source files to /root/.jenkins/jobs/AntExamplel/workspace 


To verify the local workspace, go to the view you created, select build job and then 
click on Workspace. Verify that all files and folders are available, as provided by the 


source code repository. 


enk WE xorng 


Back to Dashboard Workspace of AntExample on master 


= changes =] & 
ix 
Ge sy m 
E 
CG 


WW workspace 


[Ê] subversion Poning Log Salses in 


Build History frend = 
osu 
ano 
on 
en 
en 
os 
es 
ou 


en 


@ Jenkins es : 
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Creating and configuring a build job fora 
Java application with Maven 


Click on New Item on the dashboard to create a new build for a Java application 


which uses Maven as a build tool. Enter the Item name and select Maven project 
from the list. 


@ Jenkins A 


S New Item Item name 


& People Freestyle project 
= This ıs the central feat 
Build History build system, and this € 


CounterApp} 


will build your project 
mething other than so! 


nding any SCM with any 


Project Relationship © Maven project 


a _ Build a maven pre 
*= Check File Fingerprint Spete 


configuratio 


g Manage Jenkins Build Flow 


A Build Flow can manage job orchestration as a dedicated entity, in 

c 9 

& Credentials »mplex orchestration and without polluting the jobs with various plugins to 2m 

downstream chain 

@ Disk usage 

yd i $; External Job 

> Tmn 00K e e execution of a pro nona 

u can use ur existin 


automation syster WM for more details 
Build Queue 


Multi-configuration project 
No buikis in the queue. + 


Build Executor Status = OK 
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It will open the configuration for the new build job. In Source Code Management, 
select Subversion. Provide Repository URL and Credentials. In Chapter 2, Installation 
and Configuration of Code Repository and Build Tools we installed Subversion, and added 
the source code to SVN. 


None 
CVS 
CVS Projectset 
Git 
® Subversion 
Modules 


Source Code Management 


Apply 


Repository URL https://192.168.1.12/svn/MS/CounterApp 


as mitesh51/****** (SVN) v| æ= Add 


Local module directory 


Repository depth infinity v 
Ignore externals | 
Add module... 
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In the build job configuration, go to the Build Triggers section and select the 

Poll SCM radio button. Provide the schedule detail in * * * * * form, as shown in 
following figure. It will poll the repository every minute to verify changes committed 
into the repository by developers. Add the Maven build step. Provide the name of 
the build file; by default it is pom.xm1. Provide Goals and Options and, if you keep it 
empty, then it will execute the default goal. 


Pre Steps 


Invoke top-level Maven targets (2) 
| 
Maven Version Mania F 


Goals can v 


= Advanced... 


Add pre-build step v 


Build 
Root POM pom xml (2) 
Goals and options package 2) 
Advanced... 
Post Steps 
Run only if build succeeds V Run only if build succeeds or is unstable 
Pin rananiece oF bull walt 


Click on Build Now to execute the build job or commit the updated code to the 
repository, and the build will be executed automatically based on our configuration 
in Build Triggers. 
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® Jenkins CH 


SOME ALT pee 


FÈ Beck to Dashdowa Maven project CounterApp 


(add deacrition 


n 
ZF Roconk Change 
(0) subver . Permalinks 
3 Build History tend = 
a | a 
E BSS for aff E) RSS for failures 


It will check out all the latest available code in the source code repository against 
the local workspace on the machine where Jenkins is installed, as shown in the 
following figure. 


@ Console Output 


Started by user anonymous 

[EnvInject] - Loading node environment variables. 

Building in workspace /root/.jenkins/jobs/CounterApp/workspace 
Checking out a fresh workspace because there's no workspace at /root/.jenkins 
/jobs/CounterApp/workspace 

Cleaning local Directory . 

Checking out https://ms/svn/JenkinsTest/trunk/CounterWebApp at revision 
*2015-05-01T10:37:28.604 -0700' 

-classpath 

-project 

CounterWebApp.war 

target 

src 

src/main 

src/main/java 

src/main/java/com 

src/main/java/com/tinyclouds 
src/main/java/com/tinyclouds/controller 
src/main/java/com/tinyclouds/controller/BaseController.java 
src/main/resources 

src/main/resources/logback. xml 

src/main/webapp 

src/main/webapp/WEB-INF 

src/main/webapp/WEB-INF/pages 
src/main/webapp/WEB-INF/pages/index.jsp 
src/main/webapp/WEB-INF/mvc-dispatcher-servlet.xml 


pPPPPP PPP PPP Pp Pp p D p 
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Once the checkout process is completed, the build file execution based on the goals 
will start, and the build execution will be successful if all dependencies and files 
required for the build execution are available in the local workspace, as shown in 
the following figure. 


[INFO] Installing /root/.jenkins/jobs/CounterApp/workspace/target 
/CounterWebApp.war to /root/.m2/repository/com/tinyclouds/CounterWebApp 
/1.0-SNAPSHOT/CounterWebApp-1.0-SNAPSHOT.war 

[INFO] Installing /root/.jenkins/jobs/CounterApp/workspace/pom.xml to /root/.m2 
/repository/com/tinyclouds/CounterWebApp/1.0-SNAPSHOT/CounterWebApp- 
1.0-SNAPSHOT.pom 

[ENIBO) == -$=s 833 H Hs 5 eS SS SSS SSS SS 
[INFO] BUILD SUCCESS 

[INFO] ------------------------------------------------------------------------ 
[INFO] Total time: 6.307 s 

[INFO] Finished at: 2015-05-01T10:37:41-08:00 

[INFO] Final Memory: 15M/36M 

[INFO] —---—--—=———==$-6-— a a e e e e e e e ae e e a ae a eee 
[JENKINS] Archiving /root/.jenkins/jobs/CounterApp/workspace/pom.xml to 

com. tinyclouds/CounterWebApp/1.0-SNAPSHOT/CounterWebApp-1.0-SNAPSHOT.pom 
[JENKINS] Archiving /root/.jenkins/jobs/CounterApp/workspace/target 
/CounterWebApp.war to com.tinyclouds/CounterWebApp/1.0-SNAPSHOT/CounterWebApp- 
1.0-SNAPSHOT.war 

channel stopped 

Deploying /root/.jenkins/jobs/CounterApp/workspace/CounterWebApp.war to 
container Tomcat 7.x Remote 

[/root/.jenkins/jobs/CounterApp/workspace/CounterWebApp.war] is not deployed. 
Doing a fresh deployment. 

Deploying [/root/.jenkins/jobs/CounterApp/workspace/CounterWebApp. war] 
Deploying /root/.jenkins/jobs/CounterApp/workspace/target/CounterWebApp.war to 
container Tomcat 7.x Remote 

Redeploying [/root/.jenkins/jobs/CounterApp/workspace/target/CounterWebApp. war] 

Undeploying [/root/.jenkins/jobs/CounterApp/workspace/target/CounterWebApp. war] 

Deploying [/root/.jenkins/jobs/CounterApp/workspace/target/CounterWebApp. war] 
Finished: SUCCESS 


Build execution with test cases 


Jenkins allows JUnit-format test results to be published on the dashboard. We need 
not install any specific plugin for this. If we have test cases already written in JUnit, 
then it is easy to execute them. Make sure to create a goal or task in the build file for 
test case execution. In Build Job configuration, click on Post-build Actions and select 
Publish JUnit test result report. Provide the location for the Test report XMLs files 
and save the build job configuration. 


Publish JUnit test result report @ 


est report AMES test-results/*.xml 


Fileset ‘includes’ setting that specifies the generated raw XML report files, such as ‘myproject/target/test-reports/* xml’. Basedir of the 
fileset is the workspace root. 


O Retain long standard output/error (2) 


Health report amplification factor 1 r @ 


1% failing tests scores as 99% health. 5% failing tests scores as 95% health 
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Execute the build by clicking on Build Now. Once the build has finished, click on the 
Test Result link on the dashboard. 


@ Jenkins C 


sa @ Build #59 (Apr 29, 2015 4:44:44 AM) W 
> a! (add descrip 
ia a Rev 

D ea ~~ 
a BE 
| ed 

mre 

Click on the package link to get detailed test results on the summary page. 

@ Jenkins OE 
te 1 Test Result 

"a rs 

4 All Tests 

à a 

[E] tes: 

@ Pn 

Click on the class link to get detailed test results on the page. 
@ Jenkins SE  . 
Test Result : com. „utils 

; t All Tests 

Ron 0 an Pa Ta 
(yt 

mn 
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Verify all tests name, the duration, and the status, as shown in the following figure: 


All Tests 


@ Jenkins CO 
É Back to Projet Test Result 

“ 2 

+ 


Test nam 


Tal: 


Verify by clicking on the individual link of each test case on the Jenkins dashboard. 


@ Jenkins A 2 
E Beck to Project Passed 

=] 2: 

5! 

gr 

[EJ tes 

@ Pre 


We have already configured the Dashboard View plugin to display the Test Statistics 
Chart and the Test Trend Chart. 


Verify the number of successful, failed or skipped tests, as well as the percentage on 
the customized view, as shown in the following screenshot. 
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Jenkins MyView 


@& New item 
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®o 


ENABLE ayto orori 
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Failed # % 
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Skipped # 
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Verify the Test Trend Chart on the Dashboard View. 
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Self-test questions 


Q1. What is the objective of installing the Dashboard View plugin? 


1. To havea portal-like view for Jenkins build jobs 
2. To run test cases related to Jenkins build jobs 


3. To display build results 
Q2. Which are the fields available to create credentials for SVN? 
1. Scope, Username, Password, Description 
2. Scope, Username, Password 
3. Username, Password, Description 
Q3. What is the meaning of * * * * * in the Schedule of Build Trigger section? 
1. Poll SCM Every Day 
2. Poll SCM Every Hour 


3. Poll SCM Every Minute 
4. Poll SCM Every Second 


Q4. What are the names of build files in Ant and Maven respectively? 


1. pom.xml, build.xml 
2. build.xml, pom.xml 
3. pom.xml, root .xml 
4. ant.xml, maven.xml 
Summary 


We are again at the part of the chapter that gives us a sense of achievement. In this 
chapter, we have covered how to customize the Jenkins dashboard and display 

test results based on the build job on the dashboard. We have also created our first 
build job for a sample Java application. We used build tools such as Ant and Maven 
for executing build and create artifacts. Finally, we have seen how test cases can be 
executed, and results can be displayed on the Jenkins portal. 


In the next chapter, we will deploy the application to application server directly from 
Jenkins, and we will also cover an introduction to deploying applications on Amazon 
Web Services. 


[66] 


Implementing Automated 
Deployment 


"Simplicity is prerequisite for reliability" 
- Edsger Dijkstra 


We have covered the concept of continuous integration, and we also know how 
to implement it using Jenkins. Now is the time to move to the next step in the 
application deployment pipeline, that is automated deployment. We will first 
understand the concept of continuous delivery and continuous deployment, 
before automated deployment into a Tomcat application server. 


This chapter will take one step forward in the deployment pipeline by deploying 
artifacts in a local or remote application server. It will give an insight into the 
automated deployment and continuous delivery process. 

e Overview of continuous delivery and continuous deployment 


e Deploying a file from Jenkins to a Tomcat server 
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An overview of continuous delivery and 
continuous deployment 


Continuous delivery is the extension of Continuous Integration practices. 
Application artifacts are production-ready in automated fashion but not deployed in 
production. Continuous deployment is the extension of continuous delivery, where 
changes in the application are finally deployed in production. Continuous delivery 
is a must for DevOps practices. Let's understand how to deploy application artifacts 
using Jenkins in the following sections. 


For more details on continuous delivery and continuous 
deployment, visit: 


a 


ke http://continuousdelivery.com/2010/08/continuous- 
delivery-vs-continuous-deployment/ 


http://martinfowler .com/books/continuousDelivery.html 


Installing Tomcat 


Tomcat is an open source web server and servlet container developed by the Apache 
Software Foundation (ASF). We will use Tomcat to deploy web applications. 


1. Goto https://tomcat .apache.org and download Tomcat. Extract all the 
files to a relevant folder in your system. 
2. Change the port number in conf/server.xml1 from 8080 to 9999. 
<Connector port="9999" protocol="HTTP/1.1" 
connectionTimeout="20000" 


redirectPort="8443" /> 


3. Open the terminal or Command Prompt based on your operating system. 
Go to the tomcat directory. Go to the bin folder, and run startup.bat or 
startup.sh. The following is an example of startup.bat on Windows. 
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ics Command Prompt = 


icrosoft Windows [Version 6.3.96001 
<c) 2013 Microsoft Corporation. All rights reserved. 


=\Users\MIteshde=: 


IEz\>cd E:\Setup\fApache Tomcat\apache-tomcat—?7.6.22\bin 


IE = \Se tup\Apache Tomcat ache-tomceat—?7.4@.22\bin>startup.bat 


CATALINA_BASE: \Setup\Apache Tomcat\apache-tomcat—7.6.22" 
CATALINA_HOME: \Setup\Apache Tomcat\apache-tomcat—7.6.22" 
CATALINA_TMPDIR: \Setup\fApache Tomcat\apache-tomcat—7.6.22\temp" 
JRE_HOME: \Program Files\Java\jdki.8.@" 

CLASSPATH: \Setup\Apache Tomcat\apache-tomcat—7.6.22\bin\bootstra 
;E:\Setup\fApache Tomcat\apache-tomcat—?7.6.22\bin\tomcat—juli. jar" 


lé Tomcat = 


Parsing configuration file [struts.xml] 
ul Øi, 2615 11:56:14 PM com.opensymphony.xwork2 .util.logging.commons .CommonsLog| 


INFO: Overriding property struts.i18n.reload — old value: false new value: true 
ul Øi, 2015 11:56:14 PM com.opensymphony.xwork2 .util.logging.commons .CommonsLog 
iger info 
INFO: Overriding property struts.configuration.xml.reload — old value: false new 
value: true 
ul Øi, 2615 11:56:14 PM com.opensymphony.xwork2 .util.logging.commons .CommonsLog| 
iger info 
Initializing Struts-Spring integration... 
ul Øi, 2615 11:56:14 PM com.opensymphony.xwork2 .util.logging.commons .CommonsLog| 
er info 
Setting autowire strategy to name 
» 2615 11:56:14 PM com.opensymphony.xwork2 .util.logging.commons .CommonsLog 
ker info 
--- initialized Struts-Spring integration successfully 
» 2615 11:56:15 PM org.apache.coyote .AbstractProtocol start 
Starting ProtocolHandler ["http-bio-8080"1 
- 2615 11:56:15 PM org.apache.coyote .AbstractProtocol start 
Starting ProtocolHandler ["ajp-bio-8009"] 
>» 2615 11:56:15 PM org.apache.catalina.startup.Catalina start 
Server startup in 16246 ms 


4. Open your browser and visit http://localhost : 9999. We can also access 
the Tomcat home page by using the IP address http: //<IP address>:9999 


Home Documentation Configuration Examples Wiki Mailing Lists Find Help 


Apache Tomcat/7.0.22 ae ache Software Foundation 


http://www.apache.org/ 


Recommended Reading: 

Security Considerations HOW-TO 
Manager Application HOW-TO 
Clustering/ Session Replication HOW-TO 


Server Status 


Manager App 


Host Manager 


Developer Quick Start 


Tomcat Setup Realms & AAA Servlet Examples Servlet Specifications 
First Web lication JDBC DataSources JSP Examples Tomcat Versions 


[69] 


Implementing Automated Deployment 


Deploying a war file from Jenkins to 
Tomcat 


We will use the Deploy plugin available at https: //wiki.jenkins-ci.org/x/ 
CAAjAQ to deploy a war file into a specific container. 


The Deploy plugin takes the war/ear file, and deploys it to a running local or remote 
application server at the end of a build. 


It supports the following containers: 


e Tomcat: 4.x/5.x/6.x/7.x 
e JBoss: 3.x/4.x 
e Glassfish: 2.x/3.x 


To deploy a war file in a Websphere container, use the Deploy WebSphere plugin 
available at https: //wiki.jenkins-ci.org/x/UgCkAg. 


To deploy a war file in a Weblogic container, use the WebLogic Deployer plugin 
available at https: //wiki.jenkins-ci.org/x/q4ahaAw. 


1. On the Jenkins dashboard, go to the Manage Jenkins link and then click on 
Manage Plugins and install Deploy plugin. 


Filter: Deploy 


Installed 
Enabled Name 


Artifactory Plugin 
v gina ep g ma 230 Uninstall 


l Version Previously installed version Pinned Uninstall 


Deploy to container Plugin 


Uninstall 
Deployment Dashboard Plugin for Jenkins 
z sind our E 107 Uninstall 
IBM UrbanCode Deploy Plugin 


x pe ea LIRE- 120 Uninstall 
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2. Wait until the installation of Deploy Plugin is complete. 


@ Jenkins 


Jenkins Update center E U H 


A Back to Dashboard Installing Plugins/Upgrades 


@ Manage Jenkins 
Preparation 
Å Manage Plugins e Checking internet connectivity 
a g e Checking update center connectivity 
+ Success 


Deploy Plugin (0) Success 


> Go back to the top page 
(you can start using the installed plugins right away) 


@ (© Restart Jenkins when installation is complete and no jobs are running 


3. Go to the Jenkins dashboard and select any build job. Click on the Configure 
link of the selected build job. 


4. Click on the Add post-build action button on the configuration page of 
the relevant job and select Deploy war/ear to container, as shown in the 
following figure. 


Jenkins AntExample1 configuration 
Ant/Ivy-Artifactory Integration 
Generic-Artifactory Integration 
Gradle-Artifactory Integration 
Inject environment variables to the build process (2) 


Ininct naceworde ta the build ac anuiranmont variables 


Aggregate downstream test results 

Archive the artifacts (2) 
Build other projects 

Publish JUnit test result report 


Publish Javadoc © 
Record fingerprints of files to track usage 

Git Publisher k 
Build other projects (manual step) Zz (2) 


Deploy war/ear to a container H 


E-mail Notification 
Editable Email Notiñcation 

Delete 
Publish artifacts to IBM UrbanCode Deploy 


Set build status on GitHub commit 


Advanced... 


Trigger parameterized build on other projects 


I Delete workspace when build is done 


Add post-build action v 
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5. It will add Deploy war/ear to a container in the Post-build Actions section. 
Provide a war file path that is relative to the workspace, and select Tomcat 7.x 
as the container from the available list box, as shown in the following figure. 


Post-build Actions 


Deploy war/ear to a container 


WARIEAR files sx war (2) 
Context path (2) 
Containers 


Add Container v 
Deploy on failure JOSS AS 3x 

JBoss AS 5.x 

JBoss AS 6.x 

JBoss AS 7.x 


Add post-build a 


Tomcat 4.x 
Save Tomcat 5.x 
Tomcat 6.x 


x Page generated: Jul 12, 2015 4:53:54 AM RESTAP| Jenkins yer 1.606 


6. Provide Manager user name and Manager password; in tomcat -users.xml, 
and uncomment the following: 


<l-- 
<role rolename="tomcat"/> 
<role rolename="role1"/> 
<user username="tomcat" password="tomcat" roles="tomcat"/> 
<user username="both" password="tomcat" roles="tomcat,rolel"/> 
<user username="rolel" password="tomcat" roles="role1"/> 


7. Add the following in the uncommented section: 


<role rolename="manager-script"/> 
<user username="mitesh51" password="*********" roles="manager- 
script"/> 


8. Restart Tomcat, visit http://localhost :9999/manager/html, and enter a 
username and password. Use the same username and password in Jenkins 
for Manager credentials. 
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Context path 


Containers 


Post-build Actions 


Deploy war/ear to a container 
WAR/EAR files 


“war 
Tomcat 7.x 
Manager username itesh54 
Manager password | ogy 
Tomcat URL http/localhost 9999 
Add Container v 


Deploy on failure 


9. Click on Build Now. 


(*) Console Output 


Started by user anonymous 

[EnvInject] - Loading node environment variables. 

Building on master in workspace /root/.jenkins/jobs/AntExamplei/workspace 
Checking out a fresh workspace because there's no workspace at /root/.jenkins 
/jobs/AntExamplei/workspace 

Cleaning local Directory . 

Checking out https://192.168.1.12/svn/MS/AntExamplei at revision 
*2015-07-12T05:42:51.081 -0700" 

license.txt 

sSonar-project .properties 

src 

sxrc/com 

src/com/ |] 
src/com/ service 
src/com/ service/| 
src/com/ service/| 
src/com/ domain 
src/com/ Idomain/___].java 

src/com/ web 

src/com/ web, .java 

WebContent 

WebContent/META-INF 

WebContent /META-INF/MANIFEST .MF 

WebContent/WEB-INF 

WebContent /WEB-INF/1lib 

AU WebContent/WEB-INF/1lib/checkstyle-6.6.jar 

AU WebContent /WEB-INF/1lib/org.springframework. beans-3.0.0.M3.jar 

AU WebContent /WEB-INF/1ib/org.springframework.core-3.0.0.M3.jar 

AU WebContent/WEB-INF/1lib/checkstyle-6.6-all.jar 

AU WebCont ent /WEB-INF/1ib/org.springframework.web-3.0.0.M3.jar 

AU WebContent /WEB-INF/1ib/commons-logging-1.0.4.jar 

AU WebContent /WEB-INF/1ib/org.springframework. context.support-3.0.0.M3.jar 
AU WebContent/WEB-INF/1ib/org.springframework. expression-3.0.0.M3.jar 
WebContent /WEB-INF/1lib/antlr-runtime-3.0.jar 

WebContent /WEB-INF/1ib/org.springframework.asm-3.0.0.M3.jar 

WebContent /WEB-INF/1lib/org.springframework.web.servlet-3.0.0.M3.jar 
WebContent /WEB-INF/1ib/org.springframework. context-3.0.0.M3.jar 
WebContent/WEB-INF/dispatcher-servlet.xml 

WebContent /WEB-INF/jsp 

WebContent/WEB-INF/jsp/userSuccess.jsp 
WebContent/WEB-INF/jsp/userForm.jsp 

WebContent /WEB-INF/ web.xml 

WebContent/redirect .jsp 

checkstyle _checks.xml 

build.xml 

At revision 26 

no change for https://192.168.1.12/svn/MS/AntExamplei since the previous build 


Se er ee 


ee ee ee ee ee 


[73] 


Implementing Automated Deployment 


10. Once the build is complete, verify the console output of the deployment of 
the application in the Tomcat application server. 


[workspace] $ /root/.jenkins/tools/hudson.tasks.Ant_ AntInstallation/Anti.9.4/bin/ant 
Buildfile: /root/.jenkins/jobs/AntExample1/workspace/build. xml 


init: 
[mkdir] Created dir: /root/.jenkins/jobs/AntExamplei/workspace/build/classes 
[mkdir] Created dir: /root/.jenkins/jobs/AntExamplei/workspace/dist 


compile: 

[javac] /root/.jenkins/jobs/AntExamplei/workspace/build.xml:16: warning: 
"includeantruntime' was not set, defaulting to build.sysclasspath=last; set to false 
for repeatable builds 

[javac] Compiling 4 source files to /root/.jenkins/jobs/AntExamplei/workspace 
/build/classes 

[javac] Note: /root/.jenkins/jobs/AntExamplei/workspace/src/com/vaannila 
/web/UserController.java uses or overrides a deprecated API. 

[javac] Note: Recompile with -Xlint:deprecation for details. 


war: 
[war] Building war: /root/.jenkins/jobs/AntExamplei/workspace 
/dist/AntExample.war 


BUILD SUCCESSFUL 
Total time: 13 seconds 


Started calculate disk usage of build 

Finished Calculation of disk usage of build in 0 seconds 
Started calculate disk usage of workspace 

Finished Calculation of disk usage of workspace in 0 seconds 
Finished: SUCCESS 


11. Verify the webapps directory in the Tomcat installation directory. 
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webapps - File Browser 
File Edit View Go Bookmarks Tabs Help 


bak v prow €OR8 ae a 


Ei Location: [r/apache-tomcat-7.0.22/webapps a | Q 100% Q | icon view 


Placesv x | = —— el 
(root | 


© 


Desktop AntExample docs examples 
(J File System —— —— —— 
Œ Network 

@ Trash host-manager manager ROOT 


(B® Documents 


Music A 


í Pictures 
=i AntExample.war 
ideos 


Downloads 


7 items, Free space: 6.2 GB 


12. Verify the Tomcat manager, and check the status of an application in the 
Tomcat application server. 


SR” Apache 


Software Foundation 
http://www.apache.org/ 


Tomcat Web Application Manager 


Message: | on 
List Applications HTML Manager Help Manager Help Server Status 
Start | Stop Reload Undeploy 
I None specified Welcome to Tomcat true 0 
Expire sessions with idle > 30 minutes 
Start Stop Reload Undeploy 
JAntExample None specified AntExample true 0 = = 
Expire sessions withidle = 30 minutes 
Start Stop Reload Undeploy 
‘docs None specified Tomcat Documentation true 0 
Expire sessions with idle > 30 minutes 
Start Stop Reload  Undeploy 
fexamy None specified Servlet and JSP Examples true 0 n 
Expire sessions with idle > 30 minutes 
Start | Stop Reload Undeploy 
host-manager None specified Tomcat Host Manager Application true 0 
Expire sessions with idle > 30 minutes 
Start Stop Reload Undeploy 
/manager Ne cified Tomcat Manager Application true 
S, 1 Expire sessions with idle > 30 minutes 
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13. If the Tomcat server is installed on a remote server, then use the IP address in 
the Tomcat URL, as shown in the following figure: 


Post-build Actions 


Deploy war/ear to a container 


WARIEAR files eee war © 
Context path (2) 
Containers 

Tomcat 7.x 


Manager username jiteghs4 


Manager password sessooo 


Tomcat URL http://192.168.199.142:9999 


Add Container v 


Deploy on failure 


We only need to change the Tomcat URL in case of remote deployment. 


Self-test questions 

Q1. Continuous delivery and continuous deployment are the same. 
1. True 
2. False 


Q2. How do you enable Tomcat manager access? 


Start Tomcat 

Modify server.xml 
Modify tomcat-users.xml 
Modify web.xml 


PON 
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Summary 

Well done! We are at the end of the chapter; let's summarize what we have covered. 
We have understood the concept of continuous delivery and continuous deployment. 
The main concept we have covered here is the deployment of application artifacts in 
the specific application server after the build is successful. 


In the next chapter, we will learn how to manage Jenkins on Cloud, and look at some 
case studies. 
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"Productivity is being able to do things that you were never able to do before" 
-Franz Kafka 


We have understood the concepts of continuous delivery and continuous 
deployment. We have also seen how to deploy the war file from Jenkins to the 
Tomcat server. Now, we will see how hosted Jenkins can be leveraged. Different 
service providers offer Jenkins as a service. We will see how OpenShift and 
CloudBees provide Jenkins to users. 


This chapter describes details on how to use hosted Jenkins, which is provided by 
popular PaaS providers, such as Red Hat OpenShift and CloudBees. This chapter 
also covers details on how various customers are using Jenkins based on their 
requirements. This chapter will explore details on how to use Cloud-related 
plugins in Jenkins for effective usage of Jenkins. We will cover the following 
topics in this chapter: 


e Exploring Jenkins in OpenShift PaaS 
e Exploring Jenkins in the Cloud - CloudBees 
e An overview of CloudBees Enterprise Plugins 


e Jenkins case studies from CloudBees 
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Exploring Jenkins in OpenShift PaaS 


OpenShift Online is a public PaaS — application development and hosting platform 
from Red Hat. It automates the process of provisioning and deprovisioning, 
management, and scaling of applications. This supports command-line client tools 
and a web management console to launch and manage applications easily. The 
Jenkins app is provided by OpenShift Online. OpenShift Online has a free plan. 


1. To sign up for OpenShift Online, visit https: //www.openshift .com/app/ 
account /new. 


OPENSHIFT 


Already have an account? Sis 


You'll love OpenShift because it has: 


2. Once you sign up, you will get the welcome screen at 
https://openshift.redhat.com/app/console/applications. 


3. Click on Create your first application now. 
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Applications 


Welcome to OpenShift 


OpenShift helps you build and deploy web applications, mobile backends, service oriented architectures, and 
host your favorite services. 


1. Choose a web framework or codebase to start from 
Try JBoss, PHP, Python, Ruby, Node.js, or create a new Drupal or Wordpress site instantly. 
2. Add cartridges like MySQL or MongoDB to your application 
OpenShift lets you add services and tools to your application through cartridges - including databases, cache servers, management tools, and 


continuous integration servers. 


3. Upload your code to OpenShift via Git 


Your source code is stored with your application in a Git version control repository. 


— Create your first application now 


4. Choose a type of application, in our case, select Jenkins Server. 


OPENSHIFT ONLINE 


Applications Ss Help v 


1) Choose a type of application 2) Configure the application 3) Next steps 


Choose a web programming cartridge or kick the tires witha @ Cartridge - A managed runtime for your application. 


quickstart. After you create the application you can add QuickStart - A quick way to try out a new technology with code 
cartridges to enable additional capabilities like databases, and libraries preconfigured. You are responsible for updating 
metrics, and continuous build support with Jenkins. core libraries for security updates. 


U Receives automatic security updates 
Search by keyword or tag Q |Or Browse by tag... ~ 


Instant App see all xPaaS see all 


Jenkins Server JBoss Data Virtualization 6 
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5. Give Public URL for your Jenkins server, as shown in the 
following screenshot: 


Applications Settir 


S ielp C shift Hub 


1 2.) Configure the application 


Based On Jenkins Server Cartridge @ 
Jenkins is a continuous integration (CI) build server that is deeply integrated into OpenShift 
See the Jenkins info page for more. Based on Jenkins 1.509+ 
http://www. jenkins-ci.org 
¥ OpenShift maintained 


U Receives automatic security updates 


Public URL http:// | jenkins -msclouds.rhcloud.com 


OpenShift will automatically r 


ster this domain name for your application. You can add 


your own domain name later 


Source Code Optional URL to a Git rey 


6. Click on Create Application. 


Cartridges Jenkins Server 


Applications are composed of cartr 


s - each of which exposes a service or capability 


to your code. All applications must have a web cartridge. 


Scaling No scaling 


Opensnift automatically rout 


web requests to your web gear. This application shares 
filesystem resources and can't be scaled 


Region O No preference 


© aws-us-east-1 


) aws-eu-west-1 


D aws-ap-southeast-2 
) aws-us-west-1 


D aws-eu-central-1 


Gears within your application will run on ser 


n the specified r 


Back Create Application +10 
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7. Click on visit app in the browser. 


OPENSHIFT ONLINE 


Applications Settings Support 


3) Next steps 


Will you be changing the code of this application? 
Yes, help me get started 


Not now, continue 


Or visit app in the browser 


8. Access the Jenkins in the web browser. Then, log in with the provided 
credentials in the OpenShift dashboard. 


- 
Jenkins ees 
user: | 
Password 
Remember me on this computer 
login 
Help us localize this page BESTARI Jenkins ver, 1,565.3 


[ 83] 


Hosted Jenkins 


9. The following is the screenshot of the Jenkins dashboard: 


Jenkins * 


= New Item Welcome to Jenkins! Please create new jobs to get started. 
& People 

> Build History 

Z Manage Jenkins 

A Credentials 

& My Views 


Build Queue > 
No builds in the queue. 


REST API 


Wh Help us localize this page 


Exploring Jenkins in the 
Cloud — CloudBees 


DEV@cloud is a hosted Jenkins service in a secure, multi-tenanted environment 
managed by CloudBees. It runs a specific version of Jenkins, along with a selected 
version of plugins which are well supported with that version. All updates and 
patches are managed by CloudBees, and limited customization is available. 


1. Goto https: //www.cloudbees.com/products/dev and subscribe. 


CloudBees Platform 


Continuous Delivery in the Cloud 


Kotorpeive ial Starter Professional Enterprise 


Eda Account Settings 


Enterprise Trial Starter Professional Enterprise 

$0/month $60/month $100/month $200/month 

50 max users 5 max users 20 max users ‘SO max users 
supscribe Setncrive Subscrive suniuioe 

Try out the Enterprise Ther free for two Enjoy untimited paralel builds with 


weeks. flenible, by th 


ng, 


Use an “mi.larg: quivalent build 
process ‘or $0.425/hour ot a laptop 
equivalent processor for $1.32/hour. 
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2. Once we complete subscription process, we will get the dashboard of 
CloudBees, as shown in following screenshot. Click on Builds. 


ha dovdbetsiom Sie er 


mesh sonics sqomancom Oie 


totc y n 
[von 
i A Get Started vith Builds 
5 
Mitesh | A t (nma [~] ui 

& New item Welcome to Jenkins! 
& reo 

=, óH Please Create New JODS to get started 

Bud History 


JEV@cloud Slave Templates 


Build Queue — 


he QuevE 
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4. Click on Manage Jenkins to configure and install plugins. 


A  Bullds Ecosystem Support Documentation Mitesh | A CTE | mA 
EÈ New tem Manage Jenkins 
& People 
T> Build History P 
g. Manage Jenkins Aa Read guratior 


DEV@cloud Slave Templates 


ad 
3 Support Manage Plugin 
(updates available) 
y 


Ah Credentials 


& My Views 


& Groups 
A Roles | ] 


> Before configuring a build job, we need to store the source 


GA code of an application in the repository service provided by 
CloudBees. Click on Ecosystem, and then click on Repositories. 


@ Builds Ecosystem Support Documentation 


> 
DEV@clo Contact Learning Edit 
Builds Support Resources Users 
Cloud resources 
n 
8 CITE 
a 
g 
8 
= ZN Get Started with Builds 


A9 
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5. Click on the subversion repositories or Add Repository, and get the URL of 
the repository. 


a 


backup 
16 Jul 2015 


private 
16 Jul 2015 


release 
16 Jul 2015 


snapshot 
16 Jul 2015 


yoeqpoe4 


Builds 


Ecosystem 


Support Documentation 


Add Repository 


Use the repository services to store your source code and artifa 


offers Git, Subversion and Maven repositories 
For me 


ore help, brov cumentatior 


forum on StackOverflov 


umentatic 


port forum on StackOv 


and support articles. Additional help can be found by br 


ts used or built by your jobs. CloudBees currently 


wsing our support 


6. Click on the application folder to import it into the subversion repository 
provided by CloudBees. Use TortoiseSVN or any SVN client to import 


the code. 


Home Share 


€ + 


Fr Favorites 
E Desktop 
Jý Downloads 
E] Recent places 


Gm SkyDrive 


( Libraries 
_*] Documents 


a Music 


E] Pictures 


B Videos 


| Computer 
x Local Disk (C:) 
a New Volume (D:) 
(a New Volume (E:) 
æ RECOVERY (F:) 
3 CD Drive (H:) OFFICI 


Gia Network 


View 


T |) > Computer » New Volume (D:) » #2015 » JenkinsBook » Reference Material » SampleApps > 


Name 


[i AntExamplet AOnSe 344 Ane eo 
dÈ AntExampleApplicationBuild 
d CounterApp 

@ myapp 

pp Settle v0.4 2 

Lp) settletest 

|) settletest - Copy 

|) settletest! 

=| settle _v041_sre 

L=] settletest 


Open in new window 

Pin to Start 

Add to VLC media player's Playlist 
Open as Notebook in OneNote 
Play with VLC media player 


Share with 


SVN Checkout... 
TortoiseSVN 


www AD 


Include in library 

Norton Internet Security 

Add to archive... 

Add to "AntExample1.rar" 

Compress and email... 

Compress to "AntExample1.rar" and email 


Send to 


Cut 
Copy 


Create shortcut 
Delete 


Rename 


Properties 


Repo-browser 


Export... 


Create repository here 


| Import... N 


Settings 
Help 
About 


[87] 


Hosted Jenkins 


7. Provide the URL of a repository we copied from CloudBees, and click on OK. 


URL of repository: 
9s://svn-jenkinsuser 15. forge. cloudbees.com/mysvncloud2015/AntTest{ v] as 


Import message 
Recent messages 


8. Provide authentication information (the username and password are same as 
our CloudBees account). 


Click on OK. 


<https: //svn-jenkinsuser 15. forge. doudbees.com:443> 
jenkinsuser 15 repository 


Requests a username and a password 
| mitesh2015 
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Adding 
Adding 
Adding 
Adding 
Adding 
Adding 
Adding 
Adding 
Adding 
Adding 
Adding 
Adding 
Adding 
Adding 
Adding 
Adding 
Adding 
Adding 
Adding 
< 


9. 


The import process will take some time based on the size of the source files. 


Path 

D:\#2015\JenkinsBook\Reference Material\SampleApps\AntExample1\WebContent\WEB-INF\lib\checkstyle-6.6-all.jar 
D:\#2015\JenkinsBook\Reference Material\SampleApps\AntExample1\WebContent\WEB-INF\lib\checkstyle-6.6.jar 
D:\#2015\JenkinsBook\Reference Material\SampleApps\AntExample1\WebContent\WEB-INF\lib\commons-logging-1.0.4.ja 
D:\#2015\JenkinsBook\Reference Material\SampleApps\AntExample1\WebContent\WEB-INF\lib\org.springframework.asm 
D:\#2015\JenkinsBook\Reference Material\SampleApps\AntExample1\WebContent\WEB-INF\lib\org.springframework.bear 
D:\#2015\JenkinsBook\Reference Material\SampleApps\AntExample1 \WebContent\WEB-INF\lib\org.springframework.cont: 
D:\#2015\JenkinsBook\Reference Material\SampleApps\AntExample1\WebContent\WEB-INF\lib\org.springframework.cont: 
D:\#2015\JenkinsBook\Reference Material\SampleApps\AntExample1\WebContent\WEB-INF\lib\org.springframework.core 
D:\#2015\JenkinsBook\Reference Material\SampleApps\AntExample1 \WebContent\WEB-INF\lib\org.springframework.expr 
D:\#2015\JenkinsBook\Reference Material\SampleApps\AntExample1\WebContent\WEB-INF\lib\org.springframework.web 
D:\#2015\JenkinsBook\Reference Material\SampleApps\AntExample1\WebContent\WEB-INF\lib\org.springframework.web 
D:\#2015\JenkinsBook\Reference Material\SampleApps\AntExample1\WebContent\WEB-INF\web.xml 
D:\#2015\JenkinsBook\Reference Material\SampleApps\AntExample1\WebContent\redirect.jsp 
D:\#2015\JenkinsBook\Reference Material\SampleApps\AntExample1 \build.xml 

D:\#2015\JenkinsBook\Reference Material\SampleApps\AntExample1 \checkstyle_checks.xml 
D:\#2015\JenkinsBook\Reference Material\SampleApps\AntExample!1 \license. tt 

D:\#2015\JenkinsBook\Reference Material\SampleApps\AntExample1\sonar-project. properties 
D:\#2015\JenkinsBook\Reference Material\SampleApps\AntExample1\src 

D:\#2015\JenkinsBook\Reference Material\SampleApps\AntExample1\src\com 


Verify the Repository URL on the browser, and we will find the recently 
imported project in it. 


€ @ hitps://svn-nirma.forge.cloudbees.com/test/AntExample1/ ¢ 
a 


test - Revision 1: /AntExample1l 


WebContent/ 

build.xml 
checkstyle_checks.xml 
license.txt 
sonar-project.properties 
sre/ 
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10. Verify the Jenkins dashboard after the successful import operation. 


Ñ Builds Ecosystem Support Documentation 


Add Repository 


backup 


16 Jul 2015 


private 
16 Jul 2015 


release Largest 
16 at 2015 


snapshot 
16 Jul 2015 1 te 
m j 


test (OMB 


Count Storage Repositories 


git 


yoRqpaeg 


11. Click on New Item on the Jenkins dashboard. Select Freestyle project, 
and provide a name for a new build job. Click on OK. 


Ü Builds Ecosystem Support Documentation Mitesh | A r come | 


& New item 

& People ©) Freestyle project 
ww Bulld History 5 

7. Manage Jenkins Build a maven project 


DEV@cloud Slave Templates 


Folder 
8 Support . at h 
ara! arr a J y as the are |i 
4. Credentials 
& My Views Monitor an external job 
This type of jab allows you to record the exeautior a proce outside Jenkins, even on a remote machine This 
& Groups a 4 a t Jocumer 
®& Roles Multi-configuration project 
Build Queue > OK 


[90] 


Chapter 5 


12. The configuration page will allow us to configure various settings specific to 
the build job. 


Mitesh 


ny Bullds n Support Documentation 


$È Back to Dashboard ject name AntExamplet 
Status 
we Changes 


Way Workspace 


É) Bulld Now 
[Escaped HTML] Preview 
© Delete Project 7] Discard Old Build © 
nfigure Strategy 
7 Config Aeg Log Rotat z 
& Groups tok buld 
ays lo keep t = z 
A Roles 
{ not empty, burkd records are only kept up to this number of days 


j Move 


Build Hist trend = 


13. Configure the Subversion repository in the build job. 


@& Builds Ecosystem Support Documentation Mitesh | Account uf 


Jenkins AntExample1 configuration 


(®) Subversion 


Modules pa 
i lec a http://svn-nirma.forge.cloudbees.com/test/(AntExample1/ © 
Local module directory (optional) © 
Repository depth infinity v (2) 
Ignore externals | (2) 


Add more locations... 


Check-out Strat 
ney Use 'svn update' as much as possible 


Use 'svn update’ whenever possible, making the build faster. But this causes the artifacts from the 
previous build to remain when a new build starts 
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14. Click on Apply, and then click on Save. 


Builds Ecosystem Support Documentation Mitesh | Account a I 


Jenkins AntExample1 configuration 
Build 
Invoke Ant © 
Targets | War v'@ 


Advanced... 


Add build step x 


15. Click on Build Now. 


ý Bullds Eco n Suppo! Documentation Login SignUp Ê 


we’ Changes Disable Project 


Wa) Workspace 


©) Build Now ay ots 
© Delete Project enennees 
g Configure aay Recent Changes 
& Groups 

Permalinks 
$ Roles 


E] Forge Hook Log 


» Move 


Build History trend == 
#1 Jul46, 2015 2:57:53 PM 
a a m 
6) RSS for al EJ RSS for failure 
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Verify Console Output. 


@ Builds Ecosystem Support Documentation Mitesh | Acr [oma ~] com | 


= ase i) Console Output 


Status 
> Changes 
ae Console Output 
View as plain text 
> Edit Bulld information “SRI 
© Delete Build : 
= Tag this build ` 


Executed Ant Targets 


Then, it will compile the source files, and create a war file based on the 
build.xml file, as this is an Ant-based project. 


@ Bullds Ecosystem Support Documentation Mitesh | A 
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16. Verify the Jenkins dashboard for a successful build. 


Builds Ecosystem Support Documentation Mitesh | A 


E New item All + 
& People S w Name ; Last Success Last Failure Last Duration Deployed On 
> Build History (=) 2 AntExample }min 18 sec - #1 NIA 13 sec & NIA 
g Manage Jenkins icon SM 

DEV@c 
8 Support 
A Credentials 
& My Views 
$è Groups 
@& Roles 


joud Slave Templates 


An overview of CloudBees Enterprise 
Plugins 


The following are some important CloudBees Enterprise Plugins: 


Workflow Plugin 


It is a complex task to manage software delivery pipelines, and developer and 
operations teams need to manage complex jobs that can take days to complete. 
The Workflow plugin supports complex pipelines. The plugin uses Groovy DSL 
for workflows, and it also provides the facility to pause and restart jobs, to and 
from both master and slave failures. 


To read more on this, visit https: //www.cloudbees.com/products/cloudbees- 
jenkins-platform/team-edition/features/workflow-plugin. 


Checkpoints Plugin 


Let's consider a scenario where a long running build job fails almost at its end phase. 
This can hamper delivery schedules. The Checkpoints plugin provides the facility to 

restart workflows at checkpoints. Hence, it eliminates delays due to master and slave 
failures. In addition, it can help to survive Jenkins and infrastructure failures. 
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To read more on this, visit https: //www.cloudbees.com/products/jenkins- 
enterprise/plugins/checkpoints-plugin. 


Role-based Access Control Plugin 


Authentication and authorization plays a significant role in the security aspect. The 
authorization strategy can help to control access to Jenkins jobs effectively. It is also 
essential to set permissions at the project level and visibility. The Role-based Access 
Control (RBAC) plugin provided by CloudBees provides the following features: 


e To define various security roles 
e To assign rules to groups 
e To assign roles globally or at an object level 


e To delegate management of groups for specific objects to users 


To read more about the Role-based Access Control Plugin, visit https: //www. 
cloudbees.com/products/jenkins-enterprise/plugins/role-based-access- 
control-plugin. 


High Availability Plugin 

The downtime of Jenkins master caused by software or hardware affects the entire 
product team. It is vital to bring Jenkins master up in quick time, and this will take 
many hours. The High Availability plugin eliminates downtime due to master 
failures, by keeping multiple masters as backups. A backup master automatically 
boots up when the failure of the master is detected. This plugin makes failure 
detection and recovery an automatic process and not manual. 


To read more on this, visit https: //www.cloudbees.com/products/jenkins- 
enterprise/plugins/high-availability-plugin. 


VMware ESXi/vSphere Auto-Scaling Plugin 


Let's consider a scenario where you need multiple slaves for Jenkins running in 

your existing infrastructure to utilize underutilized capacity of your virtualized 
infrastructure based on VMware. The VMware vCenter Auto-Scaling plugin allows 
you to create slave machines that are available in your VMware-based virtualized 
infrastructure. It is possible to configure pools of virtual machines that have identical 
and multiple VMs. 
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The following actions are allowed on VMs: 


e Power on 
e Power off/suspend 


e Revert to the last snapshot 


To read more, visit https: //www.cloudbees.com/products/jenkins- 
enterprise/plugins/vmware-esxivsphere-auto-scaling-plugin. 


To find details on all plugins provided by CloudBees, visit https: //www. 
cloudbees.com/products/jenkins-enterprise/plugins. 


Jenkins case studies from CloudBees 


We will cover some case studies from CloudBees, where Jenkins is used effectively. 


Apache jclouds 


Apache jclouds is an open source multi-cloud toolkit that provides the facility to 
manage workloads on multiple clouds. It was created on the Java platform, and 
provides complete control to use cloud platform-specific features to create and 
manage applications. It provides seamless portability across various cloud platforms. 
Apache jclouds support 30 cloud providers and cloud software stacks such as Joyent, 
Docker, SoftLayer, Amazon EC2, OpenStack, Rackspace, GoGrid, Azure, and Google. 
Apache jclouds has a remarkable user base such as CloudBees, Jenkins, Cloudify, 
cloudsoft, Twitter, Cloudswitch, enStratus, and so on. 


Challenge 


The jclouds community uses Jenkins CI for continuous integration. Day by day, 

it was getting more difficult to manage and maintain Jenkins, and it was a costly 
affair. Managing Jenkins was a time-consuming and tedious task. Most of the time 
developers were involved in the managing of Jenkins, and not in writing the code 
to make jclouds more effective. 


Solution 


The jclouds team explored PaaS offerings available in the market and considered 
CloudBees, which will help them to eliminate infrastructure management and 
maintenance. It was recognized by the jclouds team that it is easy to shift the Jenkins 
CI work to DEV@cloud and immediately gain productivity benefits from developers. 
Almost 4 hours were saved weekly from the maintenance activity of Jenkins. 
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Benefits 


e 100% focus on software development, by eliminating activities such as 
server reboots, server sizing, software updates, and patches, as they are 
automatically performed from within the CloudBees service 


e 33% increase in developer productivity 


e Technical support from CloudBees for Jenkins CI issues 


To read more about this case study, visit https: //www.cloudbees.com/casestudy/ 
jclouds. 


Global Bank 


Global Bank is one of the top Global Financial Institutions. It offers corporate and 
investment banking services, private banking services, credit card services and 
investment management. It has a substantial international presence. 


Challenge 


Global Bank's existing process was suffering from a fragmented build process, 
non-approved software versions, and a lack of technical support. There was a pool 
of central control or management, and standardization of the process. Build assets 
were not accessible all the time. There was a need for secure automated process for 
application build services with audit capabilities. Jenkins provided standardization 
along with other benefits of a centralized management with robustness and 

the availability of useful plugins. After using open source Jenkins, the financial 
institution faced other challenges that were not available in open source Jenkins. 
More features were needed for approvals, security, backup, and audit. 


Solution 


To overcome existing challenges, Global Bank evaluated and selected CloudBees 
Jenkins Enterprise, considering the additional plugins for high availability, backup, 
security, and job organization, and the ability to obtain technical support for open 
source Jenkins and open source Jenkins plugins. Global Bank utilized technical 
support from CloudBees for setting up CloudBees Jenkins Enterprise. 
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Benefits 


e RBAC Plugin provides security and additional enterprise-level functionality. 
The Folders plugin offers version control and ensures that only approved 
software versions are shared. 


e Halfa day of development time is saved per application, by eliminating the 
need of monitoring the local instance of the build for each application. 


e Availability of technical support capabilities. 


To read more, visit https: //www.cloudbees.com/casestudy/global-bank. 


Service-Flow 


Service-Flow provides online integration services, to connect the disparate IT 
service management tools used by organizations and various stakeholders. It 
provides features to create ticket automatically, ticket information exchange, and 
ticket routing. It has adapters for many ITSM tools such as ServiceNow and BMC, 
as well as Microsoft Service Manager Fujitsu, Atos, Efecte, and Tieto. 


Challenge 


Service-Flow wanted to build its own service without using any of the generic 
integration tools for achieving agility. Service-Flow had several requirements, 
such as focus on agility, which required a platform for rapid development and 
frequent incremental updates, support for Jenkins, control over data, reliability, 
and availability. 


Solution 


Service-Flow used the CloudBees platform to build and deploy its ITSM integration 
service. DEV@cloud has been utilized by establishing the version control repository, 
coding first Java classes, setting up some basic Jenkins jobs, running unit tests, 
executing integration tests, and other quality checks. The Service-Flow service is in 
the cloud with a rapidly growing customer base by adding new features using the 
CloudBees platform. 


Benefits 


e Development time reduced by 50 percent with production release in 
three months 


e Updates deployed multiple times a week without service downtime 


e Availability of 99.999 percent achieved in production 
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To read more, visit https: //www.cloudbees.com/casestudy/service-flow. 


For more case studies, visit https: //www.cloudbees.com/customers. 


Self-test questions 
Q1. What is true about Workflow Plugin provided by CloudBees? 


To pause and restart jobs, to and from both master and slave failures 
To manage software delivery pipelines 

It uses Groovy DSL for workflows 

All of the above 


PFO N 


Q2. What are the features of RBAC Plugin provided by CloudBees? 


To define various security roles 

To assign rules to groups 

To assign role globally or at an object level 
All of the above 


PON 


Q3. What actions can be performed by VMware ESXi/vSphere Auto-Scaling Plugin 
provided by CloudBees? 


1. Power on 

2. Power off/suspend 

3. Revert to the last snapshot 
4. All of the above 


Summary 


The interesting thing about the ending of a chapter is: each chapter that is ending 
leads you to a new beginning. We know how to configure, manage, and use Jenkins 
on Cloud service models such as PaaS, RedHat OpenShift, and CloudBees. We also 
covered some interesting enterprise plugins from CloudBees, which add a lot of 
flexibility and value. In the last section, we have all provided details on various case 
studies on how Jenkins proved to be beneficial to a lot of organizations, and how 
they leveraged functionality of Jenkins to gain a competitive edge. 
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"Limit your burden by making very small incremental changes" 
-Anonymous 


We saw how various customers are using Jenkins on Cloud, based on their 
requirements. We also saw cloud-based offerings from Red Hat OpenShift and 
CloudBees, and case studies to understand how Jenkins is used effectively. Now, 

it is time to know about additional aspects of code quality inspection and notification 
on build failure. 


This chapter will teach you how to integrate static code analysis behavior into 
Jenkins. Code quality is an extremely vital feature that impacts application's 
effectiveness and by integrating it with sonar, Checkstyle, FindBugs, and other 
tools, the user gets an insight into problematic portions of code. 


e Integration with Sonar 


e Exploring Static code analysis Plugins 


e E-mail Notifications on Build status 


Integration with Sonar 


Quality of code is one of the important facets of DevOps culture. It provides 
quality checks that highlight the level of reliability, security, efficiency, portability, 
manageability, and so on. It helps to find bugs or possibility of bugs in the source 
code and sets culture to align with coding standards in the organization. 
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SonarQube is the open source platform for continuous inspection of code quality. It 
supports Java, C#, PHP, Python, C/C++, Flex, Groovy, JavaScript, PL/SQL, COBOL, 
Objective-C, Android development, and so on. It provides reports on coding 
standards, code coverage, complex code, unit tests, duplicated code, potential 

bugs, comments, design and architecture. 


1. Goto http: //www.sonarqube.org/downloads/, and download 
SonarQube 5.1. 


sonarqube \ 


Features Get S$ ort Get Involvec D rent R vap Resources Blog Company 


Download 


System Requrements — Installation Instructions — Upgrade Instructions — License 


SonarQube 5.1.1 - Jun 5, 2015 
New overall layout, merge Issues Driidown with Issues page. tags of issues, auto-assignment of issues, “won't fix" issues, issues report as a core feature. new Rules page, more 
efficient Component Viewer, possibility to import all files, timezone issue fixed, SonarQube binaries compatible with Java 1.7+ only 

enshots — Release notes - More details 


SonarQube 4.5.4 (LTS *) - Feb. 26, 2015 

SQALE Rating and Technical Debt Ratio, improvement of Coding Rules pages (active seventy filter, display of remediation functions, management of manual rules), various other 
improvements and bug fixes 

Download (md5) — Screenshots — Release notes - More details 


Show all versions 


* How to choose between LTS and the latest version 


2. Extract files, and it will look similar to the following screenshot: 


sonarqube-5.1 - File Browser 


File Edit View Go Bookmarks Tabs Help 


@ Back v m Fowad v $ | BS A 


Ed < | sonarqube-5.1 | logs | Q 100% Q | Icon View $ 
Placesv > 4 San —_ a | 
> A pm ma = 
root 
Desktop bin conf data 
{J File System i es = 
tŒ Network | | | 
@ Trash extensions lib logs 
Documents = 
> . —— mo 
Music | | 
Pictures Lcon 
— tem web COPYING L 
fil Videos x] P a 


9 items, Free space: 13.5 GB 
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3. Go to the bin folder to run SonarQube based on the operating system on 
which you want to run Sonar. 


bin - File Browser 


File Edit View Go Bookmarks Tabs Help 
@ Back ~ t z =| t 
Ed | < | | sonarqube-5.1 | sonarqube-5.1 | bin & 100% © | Icon View fo} 
P 
| | 

root 
Desktop jsw-license linux-x86-32 linux-x86-64 
LJ File System —— a = 
fŒ Network | | | 
@ Trash macosx-universal- solaris-sparc-32 solaris-sparc-64 
Documents 64 
Music —— —— —— 
Pictures | | | 
Videos solaris-x86-32 windows-x86-32 windows-x86-64 
Downloads 
9 items, Free space: 13.5 GB 


4. Select a folder based on your platform, in our case, we are installing it on 
CentOS, and so we will select 1inux-x86-64. 


linux-x86-64 - File Browser 
File Edit View Go Bookmarks Tabs Help 


Back ~ tO alin 


Ed |< | sonarqube-5.1 || bin || linux-x86-64 @& 100% Q | Icon View | 


©> 


Placesv x mo 11169 


| 
(root |?) E 


Desktop lib sonar.sh SonarQube.pid 
D File System 

iŒ Network & 

@ Trash wrapper 

(@ Documents 

Music 

E Pictures 

(& Videos 

Downloads 

4 items, Free space: 13.5 GB 
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5. Open the terminal and go to the SonarQube home directory; go to 
bin/linux-x86-64/ and run sonar.sh. We need to use parameters 
with sonar. sh, as shown in the following usage: 


[root@localhost linux-x86-64]# ./sonar.sh 


Usage: ./sonar.sh { console | start | stop | restart | status | 


dump } 

ca root@localhost:/tmp/sonarqube-5.1/sonarqube-5.1/bin/linux-x86-64 el 
File Edit View Search Terminal Tabs Help 

root@localhost:/tmp 34 | root@localhost:/tmp/sonarqube-5.1/sonarqu... 3¢ 


[root@localhost Linux-x86-64]# ./sonar.sh console 
Running SonarQube... 


wrapper --> Wrapper Started as Console 

wrapper Launching a JVM... 

jvm 1 Wrapper (Version 3.2.3) http://wrapper.tanukisoftware.org 

jvm 1 Copyright 1999-2006 Tanuki Software, Inc. All Rights Reserved. 

jvm 1 

jvm 1 2015.05.20 02:49:20 INFO app[o.s.p.m.JavaProcessLauncher] Launch pro 


java.awt.headless=true -Xmx1G -Xms256m -Xss256k -Djava.net.preferIPv4Stack=true 
5 -XX:+UseCMSInitiatingOccupancyOnly -XX:+HeapDumpOnOutOfMemoryError -Djava.io.t 
org.sonar.search.SearchServer /tmp/sq-process7762356701240185802properties 

jvm 1 2015.05.20 02:49:31 INFO app[o.s.p.m.Monitor] Process[search] is up 
jvm 1 2015.05.20 02:49:31 INFO app[o.s.p.m.JavaProcessLauncher] Launch pro 
a.awt.headless=true -Dfile.encoding=UTF-8 -Djruby.management.enabled=false -Djru 
utOfMemoryError -Djava.net.preferIPv4Stack=true -Djava.io.tmpdir=/tmp/sonarqube- 
onarqube-5.1/lib/jdbc/h2/h2-1.3.176.jar org.sonar.server.app.WebServer /tmp/sq-p 
jvm 1 2015.05.20 02:50:22 INFO app[o.s.p.m.Monitor] Process[web] is up 


6. Visit http://localhost:9000/ orhttp://<IP address>:9000/. 


sonarqube 
Home 
Welcome to SonarQube Dashboard PROJECTS 
Since you are al read this, it means that you have successfully started your 
SonarQube s i QG NAME- VERSION LOC TECHNICAL DEBT LAST ANALYSIS 
If you have not removed this text, it also means that you have not yet played No data 
much with SonarQube. So here are a few pointers for your next step: 
3 you now want to run analysis on a project? 
» Maybe start customizing dashboards? PROJECTS 
» Or simply browse the complete documentation? 
No data 


» If you have a question or an issue, please visit the Get Support page 


mmunity - Documentation - Get Support - Plugins - Web Service API 
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7. Explore Rules in the SonaQube dashboard. 


sonarqube 
Rules al/27 v Reload New Search 
* equals()" should not be used to test the values of “Atomic” classes ® 
zJ Language 
: "“@Override” annotation should be used on any method overriding (since Java 5) or * 
ave 
implementing (since Java 6) another one 
"BiqDecimal(double)” should not be used ‘ > 
2) Tag 
ug CHECKSTYLE OFF” suppression comments should not be used + 
"Cloneables” should implement “clone % 
pitfall compareTo” results should not be checked for specific values ® 
cent 
€ eTo" show ot return "Integer MIN_V. ] 
security ompareT wuld not return "Integer MIN VALUE » 
mista 
ConcurrentLinkedQueue size()” should not be used > 
brain-overload 
clumsy deleteOnExit” should not be used + 
multithreading 
“Double longBitsToDoubte” should not be used for “int % 


8. Verify Settings in the SonaQube dashboard. 


sonarqube 


Download 


Version 


External User Authentication 


Automatic User Creation 

Allow Users to Sign Up false 

Force authentication false 

Home Dw ust/si 
Data Dir ISF SONA 
Logs Dir ist/s 
Temp Dir ust/sor 


9. Create sonar-project .properties, and save it in a repository where the 
project is stored: 


# must be unique in a given SonarQube instance 
sonar .projectKey=Ant:project 

# this is the name displayed in the SonarQube UI 
sonar.projectName=Ant project 
sonar.projectVersion=1.0 

sonar .sources=srec 
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10. Install the SonarQube plugin in Jenkins. To know more on this, visit 
https://wiki.jenkins-ci.org/display/JENKINS/SonarQube+plugin. 


Jenkins Plugin Manager 


g Manage Jenkins 


Enabled 


t Back to Dashboard 


SonarQube Plugin 


s SonarQube, tt 


Filter: |“, sonar 


Version Previously installed version 


È 


Pinned Uninstall 


Uninstall 


11. Click on Manage Jenkins and go to Configure System. Go to the SonarQube 
section, and configure SonarQube in Jenkins. 


SonarQube installations 


Name 


Disable 


Server URL 


SonarQube account login 


SonarQube account password 


Database URL 


Database login 


Sonar 


Check to quickly disable 
SonarQube on all jobs 


http://localhost:9000/ 
Default is http:/Nocalhost9000 
admin 

SonarQube account used to 
perform analysis. Mandatory 


when anonymous access is 
disabled. 


SonarQube account used to 
perform analysis. Mandatory 
when anonymous access is 
disabled. 


Do not set if default 
embedded database 
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12. Add Build step to Invoke Standalone SonarQube Analysis in a build Job. 


Invoke Standalone SonarQube Analysis 


Task to run © 

JDK (Inherit From Job) .@ 
JDK to be used for this sonar analysis 

Path to project properties © 

Analysis properties 


JVM Options v © 


| peiste | 


13. Run the build job, and if you get a certificate error, execute the svn export 
command to solve the certificate issue. 


ERROR: Error during Sonar runner execution 
org.sonar.runner.impl.RunnerException: Unable to execute Sonar 

at 
org.sonar.runner.impl.BatchLauncher$1.delegateExecution(BatchLauncher.java:91) 

at org.sonar.runner.impl .BatchLauncher$1.run(BatchLauncher.java:75) 

at java.security.AccessController.doPrivileged(Native Method) 

at org.sonar.runner.impl.BatchLauncher.doExecute (BatchLauncher. java:69) 

at org.sonar.runner.impl .BatchLauncher. execute (BatchLauncher.java: 50) 

at org.sonar.runner.api.EmbeddedRunner. doExecute (EmbeddedRunner. java: 102) 

at org.sonar.runner.api.Runner.execute(Runner.java: 100) 

at org.sonar.runner.Main.executeTask (Main. java:70) 

at org.sonar.runner.Main.execute (Main.java:59) 

at org.sonar.runner.Main.main(Main.java:53) 
Caused by: java.lang.IllegalStateException: The svn blame command [svn blame --xml 
--non-interactive -x -w src/com/vaannila/domain/User.java] failed: svn: OPTIONS of 
"https://192.168.1.12/svn/MS/AntExamplei/src/com/vaannila/domain/User.java': 
authorization failed: Could not authenticate to server: rejected Basic challenge 


(https://192.168.1.12) 


at org.sonar.plugins.scm.svn.SvnBlameCommand. blame (SvnBlameCommand.java:110) 
at 
org.sonar.plugins.scm.svn. SvnBlameCommand.access$000 (SvnBlameCommand. java: 45) 
at org.sonar.plugins.scm.svn.SvnBlameCommand$1.call (SvnBlameCommand.java:91) 
at org.sonar.plugins.scm.svn.SvnBlameCommand$i.call (SvnBlameCommand.java:88) 
at java.util.concurrent. FutureTask.run(FutureTask.java:262) 
at 
java.util.concurrent .ThreadPoolExecutor.runWorker (ThreadPoolExecutor.java:1145) 
at 
java.util.concurrent .ThreadPoolExecutor$Worker. run (ThreadPoolExecutor.java:615 
at java.lang.Thread.run(Thread.java:745) 
ERROR: 
ERROR: Re-run SonarQube Runner using the -X switch to enable full debug logging. 
Build step ‘Invoke Standalone SonarQube Analysis' marked build as failure 
Started calculate disk usage of build 
Finished Calculation of disk usage of build in 0 seconds 
Started calculate disk usage of workspace 
Finished Calculation of disk usage of workspace in 0 seconds 
Finished: FAILURE 
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14. Execute the svn export command to solve certificate issue on a virtual 
machine where SonarQube and Jenkins are installed, as shown in the 
following screenshot: 


root@localhost:/tmp/sonarqube-5.1/sonarqube-5.1/bin/linux-x86-64 


File Edit View Search Terminal Tabs Help 


root@localhost:/tmp 3 root@localhost:/tmp/sonar... }¢ | root@localhost:/tmp/sonar... 3€ 


[root@localhost linux-x86-64]# svn export https://192.168.13.1/svn/MS/AntExample| 
1/ --username mitesh51 --password nirma51 
Error validating server certificate for ‘https://192.168.13.1:443': 
- The certificate is not issued by a trusted authority. Use the 
fingerprint to validate the certificate manually! 
- The certificate hostname does not match. 
Certificate information: 
- Hostname: MS 
- Valid: from Thu, 14 May 2015 17:24:51 GMT until Sun, 11 May 2025 17:24:51 GMT) 
- Issuer: MS 
| - Fingerprint: ac:bb:e8:17:d1:91:06:d0:2c:e2:b4:b5:54:e3:bc:60:e5:d7:93:17 
(R)eject, accept (t)emporarily or accept (p)ermanently? p 


ATTENTION! Your password for authentication realm: 


<https://192.168.13.1:443> VisualSVN Server 


can only be stored to disk unencrypted! You are advised to configure 
your system so that Subversion can store passwords encrypted, if 
possible. See the documentation for details. 


You can avoid future appearances of this warning by setting the value 
of the 'store-plaintext-passwords' option to either ‘yes’ or 'no' in 
*/root/.subversion/servers 
Store password unencrypted (yes/no)? yes 
A AntExamplel 


15. Run the build job. 


*) Console Output 


Started by user anonymous 

[EnvInject] - Loading node environment variables. 

Building on master in workspace /root/.jenkins/jobs/AntExamplei/workspace 

Updating https://192.168.1.12/svn/MS/AntExample1 at revision '2015-07-12T07:28:35.157 
-0700' 

At revision 26 

no change for https://192.168.1.12/svn/MS/AntExamplei since the previous build 
[workspace] $ /root/.jenkins/tools/hudson.tasks.Ant_AntInstallation/Ant1.9.4/bin/ant 
Buildfile: /root/.jenkins/jobs/AntExamplei/workspace/build. xml 


init: 


compile: 

[javac] /root/.jenkins/jobs/AntExamplei/workspace/build.xml:16: warning: 
"includeantruntime' was not set, defaulting to build.sysclasspath=last; set to false 
for repeatable builds 


war: 


BUILD SUCCESSFUL 

Total time: 0 seconds 

[workspace] $ /root/.jenkins/tools/hudson.plugins. sonar. SonarRunnerInstallation 
/SonarRunner/bin/sonar-runner -e -Dsonar.host.url=http://localhost:9000/ ***#*sr® 
ak eaxeee —Dsonar.projectBaseDir=/root/ .jenkins/jobs/AntExamplei/workspace 
-Dsonar.scm.password.secured=nirmaSi -Dsonar.scm.user.secured=mitesh5i 

SonarQube Runner 2.4 

Java 1.7.0_71 Oracle Corporation (64-bit) 

Linux 2.6.32-504.3.3.e16.x86_64 amd64 

INFO: Error stacktraces are turned on. 

INFO: Runner configuration file: /root/.jenkins/tools 
/hudson.plugins.sonar.SonarRunnerInstallation/SonarRunner/conf/sonar-runner.properties 
INFO: Project configuration file: /root/.jenkins/jobs/AntExamplei1/workspace/sonar- 
project.properties 

INFO: Default locale: "en_US", source code encoding: "UIF-8" (analysis is platform 
dependent) 

INFO: Work directory: /root/.jenkins/jobs/AntExamplel1/workspace/.sonar 

INFO: SonarQube Server 5.1 
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16. Verify the Sonar execution steps in the console. 


07:28:49.303 INFO - Cross-project analysis disabled 
07:28:49.389 INFO - Sensor CPD Sensor (done) | time=87ms 
07:28:49.390 INFO - No quality gate is configured. 
07:28:49.437 INFO - Compare to previous analysis (2015-07-12) 


07:28:49.444 INFO - Compare over 30 days (2015-06-12, analysis of Sun Jul 12 
07:14:15 PDT 2015) 


07:28:50.399 INFO - Execute decorators... 

07:28:51.907 INFO - Store results in database 

07:28:52.608 INFO - Analysis reports generated in 36ms, dir size=1 KB 
07:28:52.622 INFO - Analysis reports compressed in 14ms, zip size=3 KB 
07:28:52.716 INFO - Analysis reports sent to server in 94ms 


07:28:52.716 INFO - ANALYSIS SUCCESSFUL, you can browse http://localhost:9000 
/dashboard/index/Ant:project 


the server has processed the submitted analysis report. 


INFOQ: -------------------------------------=---------------------------------- 
INFO: EXECUTION SUCCESS 

INFOQ: ------------------------------------------------------------------------ 
Total time: 15.545s 


Final 
INFO: = 
Tomcat 7.x Remote 
Redeploying [/root/.jenkins/jobs/AntExamplel1/workspace/dist/AntExample.war] 
Undeploying [/root/.jenkins/jobs/AntExamplel1/workspace/dist/AntExample.war] 
Deploying [/root/.jenkins/jobs/AntExamplel/workspace/dist/AntExample.war] 
Started calculate disk usage of build 
Finished Calculation of disk usage of build in 0 seconds 
Started calculate disk usage of workspace 
Finished Calculation of disk usage of workspace in 0 seconds 
Finished: SUCCESS 


07:28:52.716 INFO - Note that you will be able to access the updated dashboard once 


Deploying /root/.jenkins/jobs/AntExamplel/workspace/dist/AntExample.war to container 


17. Refresh the dashboard of SonarQube, and we will be able to see details on the 
recently executed build in SonarQube, as shown in the following screenshot: 


Home 
Welcome to SonarQube Dashboard PROJECTS 
Since you are able to read this, it means that you have successfully started your 
SonarQuhe server Well done! QG NAME a VERSION Loc TECHNICAL DEBT 
Hf you have not removed this text, it also means that you have not yet played much with & Ant project 10 87 18min 


SonarQube So here are a few pointers for your next step 
» Do you now want to run analysis on a project? 
» Maybe start customizing dashboards? 
» Or simply browse the complete documentation? PROJECTS 
> If you have a question or an issue, please visit the Get Support page 
Size: Lines of code r: Coverage 


MY FAVOURITES 


QG NAME LAST ANALYSIS 
No data 


Configure widgets 


LAST ANALYSIS 
07:28 
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18. To get more details on code verification, click on the project, and we will be 
able to get details on Lines of Code, Duplications, Complexity, and so on. 


sonarqube 


Explore more things on SonarQube and Jenkins integration, as in the following steps. 


Exploring Static Code Analysis Plugins 


Static Code Analysis Plugins provide utilities for the static code analysis plugins. 
Jenkins interprets the result files of several static code analysis tools with the use of 
different plugins for configuration and parsing. We can have more flexibility with 
these plugins to build exactly what you want. 


To install any of these plugins, go to the Jenkins dashboard, click on Manage 
Jenkins, and select the Manage Plugins link. Go to the Available tab, find the 
respective plugin, and select it. Click on Download now, and install after restart. 


All these results are visualized by the same backend. The following plugins use the 
same visualization: 


Checkstyle Plugin 


The Checkstyle plugin generates the report for an open source static code analysis 
program, Checkstyle. 


To know more about the Checkstyle plugin, visit https: //wiki.jenkins-ci.org/ 
display/JENKINS/Checkstyle+Plugin. 
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FindBugs Plugin 
The FindBugs plugin is supported by the Static Analysis Collector plugin that shows 
the results in aggregated trend graphs, health reporting, and builds stability. 


To learn more about this, visit https: //wiki.jenkins-ci.org/display/JENKINS/ 
FindBugs+Plugin. 


Compiler Warnings Plugin 
The Compiler Warnings plugin generates the trend report for compiler warnings in 
the console log, or in log files. 


To know more, visit https: //wiki.jenkins-ci.org/display/JENKINS/ 
Warnings+Plugin. 


To publish the combined results of Checkstyle, FindBugs, and compiler warnings 
plugins, go to the Build section of any job, and click on Add post-build action and 
select Publish combined analysis results. 


Publish combined analysis results © 
Checkstyle warnings [v] 
FindBugs warnings [v] 
Compiler warnings [v] 
Run always O 


By default, this plug-in runs only for stable or unstable builds, but not for failed builds. If this plug-in should run 
even for failed builds then activate this check box. 


Health thresholds A 
2% 100% 0% 
Configure the thresholds for the build health. If left empty then no health reportis created. If the actual number of 
warnings is between the provided thresholds then the build health is interpolated. 
Health priorities D Only priority high © Priorities high and normal ® All priorities 
Determines which warning priorities should be considered when evaluating the build health. 
Status thresholds (Totals) All priorities Priority high Priority normal Priority low 
e) 
Q 


If the number of total warnings is greater than one of these thresholds then a build is considered as unstable or 
failed, respectively. l.e., a value of 0 means that the build status is changed if there is at least one warning found 
Leave this field empty if the state of the build should not depend on the number of warnings. 


We can also see these results with the use of the Dashboard View plugin. 
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In the configuration of a Dashboard view, click on Edit View and select checkboxes 


in the Number of warnings section. Add Dashboard Portlets in different sections for 
Checkstyle, Compiler, and Findbug. 


Portlets at the top of the page 


Checkstyle warnings per project 
Name Checkstyle warnings per project 


Hide zero warnings projects O 


Compiler warnings per project 
Name Compiler warnings per project 
Hide zero warnings projects [1] 


Parser AcuCobol Compiler 


Select the parser whose warnings should be shown 


Add Dashboard Portlet to the top of the view = 


Verify the view after all the changes and running build jobs. 


@ Jenkins Cs 
Jenkin: MyView È FRESH 
& New Item (Wadd desc 
& F MyView + 
eople 
= a ‘nas EJ w Name | Last Success Last Duration # Warnings 
a Bud History 
> 
Edit View 7) SA Amexamoiet 13 min- #12 Do 
© Delete view i) 1 mo 9 days - #23 57 sec 3 
Project Relationship v È PetClinic-Te 17 da x 18min © ' 
$ Check File Fingerprint = 
N $i 

7. Ma ki gend A xal (J RSS for fai 6) RSS for just latest bu 
A Croontiais Checkstyle warnings per project K oF 
@ Disk usage 

= Compiler warnings per project E » 
G Jenkins 100K 

Job | Total High Normal Low 
QMAnttxar 
Build Queue 
0 
No builds in the queve 
igp.len Ie in a utor Status = 
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The following plugins are also useful. 


DRY Plugin 


The DRY plugin shows the duplicate code blocks in your project. It only shows the 
results of duplicate code checker tools. 


To know more, visit https: //wiki.jenkins-ci.org/display/JENKINS/ 
DRY+Plugin. 


PMD Plugin 


The PMD plugin scans the pmd . xm1 files in the build workspace, and reports warnings. 


To know more, visit https: //wiki.jenkins-ci.org/display/JENKINS/ 
PMD+Plugin. 


Task Scanner Plugin 


The Task Scanner plugin scans the workspace files for open tasks and provides a 
trend report. 


To know more, visit https: //wiki.jenkins-ci.org/display/JENKINS/ 
Task+Scanner+Plugin. 


CCM Plugin 


The CCM plugin provides details on cyclomatic complexity for .NET code. 


To know more, visit https: //wiki.jenkins-ci.org/display/JENKINS/ 
CCM+Plugin. 


Android Lint Plugin 


The Android Lint plugin parses the output from the Android lint tool. 


To know more, visit https: //wiki.jenkins-ci.org/display/JENKINS/ 
Android+Lint+Plugin. 


[113] 


Managing Code Quality and Notifications 


OWASP Dependency-Check Plugin 


The Dependency-Check Jenkins Plugin features the ability to perform a dependency 
analysis build. 


To know more, visit https: //wiki.jenkins-ci.org/display/JENKINS/ 
OWASP+Dependency-Check+Plugin. 


E-mail notifications on build status 


To send an e-mail notification based on build status, we need to configure SMTP 
details. Click on Manage Jenkins, and go to Configure System. Go to the E-mail 
Notification section. 


E-mail Notification 


SMTP server smtp.gmail.com (2) 
Default user e-mail suffix (2) 
[Y] Use SMTP Authentication (2) 
= Porat com 
Password 

Pri) 
Use SSL vi © 
SMTP Port 465 (2) 
Reply-To Address Coma com 
Charset UTF-8 


Test configuration by sending test e-mail 


Go to build Job configuration, and click on Add post-build action. Select E-mail 
Notification. Provide the recipients list and save. 


E-mail Notification @ 


Whitespace-separated list of recipient addresses. May reference build parameters like $PARAM. E-mail will be sent when a build fails, becomes unstable or returns to stable. 
V| Send e-mail for every unstable build 


CI Send separate e-mails to individuals who broke the build 


(2) 


Add post-build action v 


Run the build job, and a broken build will result in an e-mail notification in 
the mailbox. 
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Self-test questions 
Q1. Which languages are supported by SonarQube? 


AT ION (OT SS g9. oN a 


Java 

C# 

PHP 

Python 

C/C++ 
JavaScript 

All of the above 


Q2. Which among these is not a Static Code Analysis plugin? 


1. DRY Plugin 

2. PMD Plugin 

3. Task Scanner Plugin 

4. FindBugs Plugin 

5. None of the above 
Summary 


Here again, we are at the end of another chapter. We need to remember that every 
new beginning comes from some other beginning's end. To summarize, we learned 
how to manage code quality of applications configured, and how to use notification 
features to send information to developers based on the failed build. We also covered 
some Static code analysis plugins in short, to get some idea about it. In the next 
chapter, we will learn how to manage and monitor Jenkins. 
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"Fall in the beginning + Fall often + Learn to recover quickly = Faster time 


to market" 


- Anonymous 


We learned Sonar integration with Jenkins, an overview of static code analysis 
plugins, and notification of build status in the last chapter. Now, it's time to focus 
on management and monitoring of Jenkins. 


This chapter gives insight into management of Jenkins nodes and monitoring of them 
with Java Melody to provide details on utilization of resources. It also covers how to 
manage and monitor build jobs. This chapter describes basic security configuration 
in detail that is available in Jenkins for a better access control and authorization. 

The following is the list of topics that we will cover in this chapter: 


Managing Jenkins master and slave nodes 

Jenkins monitoring with JavaMelody 

Managing disk usage 

Build job-specific monitoring with the Build Monitor plugin 
Managing access control and authorization 


Maintaining role and project-based security 


Managing an admin account 


Audit Trail Plugin—an overview and usage 
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Managing Jenkins master and slave 
nodes 


A master represents basic installation of Jenkins and handles all tasks for the build 
system. It can satisfy all user requests and has the capacity to build projects on its 
own. A slave is a system that is set up to reduce the burden of build projects from 
the master but delegation behavior depends on the configuration of each project. 
Delegation can be configured specifically to build job. 


1. On the Jenkins dashboard, go to Manage Jenkins. Click on Manage 


Nodes link. It will provide information on all nodes, as shown in the 
following screenshot: 


s Name | Architecture Clock Difference Free Disk Space Free Swap Space Free Temp Space Response Time 
ua Linux oe 5 
— master (amd64) In syne 5.86 GB 1.94 GB 5.86 GB Oms F 
Data obtained 48 sec 48 sec 48 sec 48 sec 48 sec 48 sec 
Refresh status 


2. To create a slave node, click on New Node. 


@ Jenkins 


Jenkins nodes 


# Back to Dashboard 
g. Manage Jenkins 
E New Node 


7. Configure 


Build Queue 


No builds in the queue. 


Build Executor Status 


1 Idle 
2 Idle 


Node name WindowsNode 

®© Dumb Slave 
Adds a plain, dumb slave to Jenkins. This is called “dumb” because Jenkins doesn't 
provide higher level of integration with these slaves, such as dynamic provisioning 
Select this type if no other slave types apply — for example such as when you are 
adding a physical computer, virtual machines managed outside Jenkins, etc 


OK 
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3. Provide Name, Description, Labels and so on. Select Launch slave 
agents via Java Web Start as Launch method. Provide Labels; in our 
case, it is javas: 


pane WindowsNode 
Dascapiioa Physical Machine Node 
# of executors 1 

Remote root directory cAjenkins 

Labels Java8 

Usage 


Utilize this node as much as possible 


Launch method Launch slave agents via Java Web Start 


Availability Keep this slave on-line as much as possible 
Node Properties 


LJ Environment variables 


Prepare jobs environment 


Tool Locations 


Advanced... 


4. Click on Save. It will open a page that gives details on how to launch the 
slave node. 


# Back t0 


Status 


Build Executor Status 


®@ Jenkins a : 


a Slave WindowsNode (Physical Machine Node) 


© This node is offline because Jenkins faited to launch the slave agent on it. See log for more datails 


Labels 
ava 


Projects tied to WindowsNode 
h 


Mark this node temporanty ofise 
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5. Open terminal on the Windows machine and run javaws 
http://192.168.13.128:8080/computer/WindowsNode/slave-agent. 


jnlp. 


x 


ee Sere iE oer jayeus http://192 .168 .13 .128=-8686/computer/WindowsNode/s lave—age Ky 


nt.jnlp 


C:\Users\MItesh> 


It will open a dialogue box for downloading the application. 


Starting application... 


Downloading application. <S > | 


Location: http://192. 168. 13. 128:8080 


Cancel 


6. Run Jenkins Remoting Agent. 


Do you want to run this application? 


Name: Jenkins Remoting Agent 


S| Publisher: Kohsuke Kawaguchi 


Location: http://192. 168. 13. 128:8080 


This application will run with unrestricted access which may put your computer and personal 
information at risk. Run this application only if you trust the location and publisher above. 


Do not show this again for apps from the publisher and location above 


EJ More Information 


Cancel 
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A small window for the Jenkins slave agent will open. 


The slave WindowsNode will be connected via the JNLP agent. 


®@ Jenkins 
Jenkins nodes WindowsNode USABLE AUTO REFRESH 
ceo E slave 
= 
à Status i 
© Delete siave WindowsNode (Physical Machine Node) 
7 Configure Connected via JNLP agent 
> Build History Created by anonymous user 
Ge Load Statistics Labels 


E Script Console 


J Log 


a System Information 


Java8g 


Projects tied to WindowsNode 


None 
(5) Disconnect 


E Monitoring 


7. On the Jenkins dashboard, go to Manage Jenkins. Click on the Manage 
Nodes link. It will provide information on all nodes, as shown in the 
following screenshot. Verify both the nodes in the Build Executor Status 
section of the leftmost sidebar. 


s Name | Architecture Clock Difference Free Disk Space Free Swap Space Free Temp Space Response Time 
ul Linux 
-A master (amd64) In syne 5.86 GB 1.94 GB 5.86 GB Oms I 
A Windows 8 z ‘ a 5 
— WindowsNode (amd64) In sync 215.13 GB 4.27 GB 215.13 GB 3340ms 
Data obtained 42 sec 42 sec 42 sec 42 sec 42 sec 42 sec 
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8. If we want to run a selective build job on to a specific node, then we can 
configure it build job-wise, as shown in the following screenshot. Check 
Restrict where this project can be run and provide Label Expression 
given to the specific node on the job configuration page. 


Jenkins AntExamplet configuration 
PE 1 } Y! Restrict where this project can be run L 2] 
os 4 ; Label Expression Javas | 
mE j 6:40 AM Slaves in label: 1 
Q Advanced Project Options 
3 
vs Advanced. 
@ #2 
Source Code Management 
on 
None 
E RSS for all E RSS for failures cvs 


CVS Projectset 
Git 
© Subversion 
Modules 


Repository URL https://192.168.1.12/sve/MS/AntExar @) 


9. Click on Build Now to execute build. Verify the console and find building 
remotely on WindowsNode we configured in the preceding section. 


It will check out the code on slave and perform operations on the specific 


node only. 
@ Jenkins seach CU 
Jenkins AntExample1 #13 
È Back to Project ws Console Output Progress: == g 
Status 
> Changes 


E Console Output 
View as plain text 
“> Edit Build Information 
Environment Variables 


@ Previous Build 


Executed Ant Targets 
init 

compile 

war 


Such configuration is useful where we want to run build job in a specific set of 
runtime environment, which is available on the specific node. 
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Jenkins monitoring with JavaMelody 


The Monitoring plugin provides monitoring of Jenkins with JavaMelody. 

It provides charts of a CPU, memory, system load average, HTTP response time, 
and so on. It also provides details of HTTP sessions, errors and logs, actions for GC, 
heap dump, invalidate session(s), and so on. Install the Monitoring plugin from the 
Jenkins Dashboard. 


Jenkins Plugin Manager 


# Back to Dashboard 
g- Manage Jenkins 
Filter: |, monitoring] 


Installed 


Enabled Name | Version Previously installed version Pinned Uninstall 


External Monitor Job Type Plugin 


v j À 14 
Monitoring 
vj iatis aal 1.56.0 Uninstall 
JavaMelody. an report afte 


1. On the Jenkins dashboard, click on Manage Jenkins. Click on Monitoring of 
Jenkins master, as shown in the following screenshot: 


BVindowstode — [olfline) 
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2. It will open the statistics of JavaMelody monitoring, as shown in the 
following screenshot. Observe all statistics: 


Statistics of JavaMelody monitoring taken at 7/14/15 9:19 AM on _localhost.localdomain (Jet,..Donate.... 
v1.606) 


@ Update A PDF @Onlinehelp Œ Desktop Choice of period: = Day 5 Week = Month = Year = All & = 
Customized 


Used memory - 1 day % CPU - 1 day 


100 
| 
aaa | 
6 


12:00 18:00 00:00 06:00 


Grean Mean: 11 
WhHaximun Maximum: 99 


Http sessions - 1 day 
200 H 


6 
12:00 18:00 00:00 06:00 


Brean Mean: 162 4 
W Hacimum Maximum: 203 M 


0.0 
12:00 18:00 00:00 06:00 


Brean Hean: 521 m 
W Haximum Maximum: 3000 m 


Active threads - 1 day 
1.6 | 
0.03700 18:00 00:00 06:00 


Bitean Mean: 12 a 
W Harimum Maximum: 1000 a 


Http hits per minute - 1 day 
400 


200 | 
(3 


12:00 18:00 00:00 06:00 


WHean Hean: 7 
Wraximum Maximum: 311 


Http mean times (ms) - 1 day 


12:00 18:00 00:00 06:00 


HiMean Mean: 31 
Whaximum Maximum: 617 


3. Scroll down the page and we will find Statistics system errors logs. 


Y Statistics system errors logs - 1 day 


Error Hits 


{WARNING ‘stapler-class' is deprecated: hudson.scm_subversion.UpdateUpdater 


1 hits/min on 26 errors a Details a Last errors 


` Current requests 
None 
@ System information 


@ Execute the garbage collector §@Generateaheapdump @ View memory histogram 3 invalidate http sessions & 
View http sessions 
4> View deployment descriptor G@)MBeans -View OS processes [E] JNDI tree 
Host localhost.localdomain@127.0.0.1 
Java memory used 137 Mb / 643 Mb A 
Nb of http sessions 3 


Nb of active threads 0 
(current http requests) 


System load 1.19 =) Details 
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4. To get more information, click on the Details link of any section. Statistics of 
HTTP are as shown in the following figure: 


+) Statistics http - 1 day 
f Request % of cumulative Hits Mean time Max time Standard % of cumulative cpu Mean cpu time % of system Mean siz — 
ie (ms) (ms) deviation e (ms) error (Kb) = 
http global | 100|5,774 24| 21,126] 415 100| 7 0.03 1 
htp | z| saol 3 1o r| 22 no 0. w| 25 
waming 
http severe 57 14 5,840| 21 126| 6,132 46 1,433 14.29 196 
44 hits/min on 290 requests = Details 
% of Mean Max | standard % of roan % of | Mean 
Request cumulative |Hits| time time cumulative p! system | size 
deviation time 
time (ms) (ms) cpu time error (Kb) 
(ms) 
uote tens icom. cloudbees jenkins GitHubPushTrigger/checkHookUn ajax 14 2| 10,683] 21,126 14.909 o 17 0.00 3 
/ ajax GET 13| 3 6,321) 6,321 6,787 6 382| 66.67 18 
iconfigure GET 13| 2 9,369| 10,498 1,595 18| 4,078 0.00 296 
job/AntExampile1/configure GET 10 3 5,183 9,984 4,170 13 7,986] 0.00 655 
|/ GET 3 9 562 3,100 954 8 421 0.00 41 
manage GET 3} 7 693| 2,409 894 6 386 0.00 20 
‘computer! GET 3| 60 75| 1,284 166 5 39 0.00 12 
/pluginManager/instalied GET 2/72 1,797| 2,379 823 2 610] 0.00 62 
Iconfig Submit POST 2| 4 826 923 174 4 457| 0.00, 0 


5. Explore more at https: //wiki.jenkins-ci.org/display/JENKINS/ 
Monitoring to get more details on the Monitoring plugin. 


Managing disk usage 


1. Disk Usage Plugin records disk usage. Install Disk Usage Plugin from the 
Jenkins dashboard. 


Jenkins Plugin Manager 


4 Back to Dashboard 


7 Manage Jenkins 


Filter: |. Disk Usagel 


Installed 
Enabled Name | Version Previously installed version Pinned Uninstall 
disk-usage plugin 
‘his plugin 0.25 Uninstall 
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2. Once the plugin is successfully installed, we will get the Disk usage link on 
the Manage Jenkins page, as shown in the following screenshot: 


Manage Old Data 
Scrub configuration files to remove remnants from old plugins and 
earlier versions. 


Disk usage 
Displays per-project disk usage 


In-process Script Approval 

Allows a Jenkins administrator to review proposed scripts (written 
e.g. in Groovy) which run inside the Jenkins process and so could 
bypass security restrictions. 

Monitoring of Jenkins master 

Monitoring of memory, cpu, http requests and more in Jenkins 
master. 

You can also view the monitoring of Jenkins nodes. 


ThinBackup 
Backup your global and job specific configuration. 


Prepare for Shutdown 
Stops executing new builds, so that the system can be eventually 


shut down safely. 


Bh E NBE 


3. The Disk Usage plugin will show project-wise details for all jobs and all 
workspace. It will also display Disk Usage Trend. 


‘@ Disk Disk Usage Trend 
bs 2754 
800 
usage 25.0 
22.5 700 
Jobs:993 MB, Builds:525 20.0 
MB, Locked builds:-, All ease 600 9. 
workspace:703 MB, Not = 
casein woe: 4 15.0 500 F m space for jobs directory 
Q 
: 9 125 “400 œ 
Builds older than z 
% 10.0 300 © |==slave workspaces 
dayago VY | Builds 15 200 leenon slave workspaces 
younger than 5.0 
25 100 
dayago y| Filter oo M, 
3 £ $ 5 i 
Project name Jobs Builds allBuilds lockedAll workspaceNot current slave workspace 
settle-build i 180MB - 53 MB - 
PetClinic-Test MS 57MB - 116 MB : 
PetClinic-Sonar MS 67MB - 116 MB > 
120 
CounterApp MB 97MB - 67 MB = 


To get more details on Disk usage plugin, visit https: //wiki.jenkins-ci.org/ 
display/JENKINS/Disk+Usage+Plugin. 
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Build monitoring with Build Monitor 
Plugin 


Build Monitor Plugin provides a detailed view of the status of selected Jenkins jobs. 
It provides the status and progress of selected jobs and names of people who might 
be responsible for "breaking the build". This plugin supports the Claim plugin, View 
Job Filters, Build Failure Analyzer, and CloudBees Folders plugin. 


@ Jenkins 
Jenkins Plugin Manager 


# Back to Dashboard 


g- Manage Jenkins 
Filter: | \ Build Monitor 


Installed 
Enabled Name | Version Previously installed version Pinned Uninstall 


Build Monitor View 


v acc ates dif 1.6+build.142 Uninstall 


1. The Dashboard View plugin will be used for creating a view that provides 
details on build job-specific monitoring. Create a new view and select Build 
Monitor View. 


@ Jenkins Ss 2 


Jenkins 
@& New Item View name My Monitoring 
& People ®© Build Monitor View 


Shows a highly visible status of selected jobs. Ideal as an Extreme Feedback Device 


Build History 
to be displayed on a screen on your office wall 


Project Relationship Build Pipeline View 
è= Check File Fingerprint Shows the Jobs in a bulld pipeline view. The complete pipeline of jobs that a version 
propagates through are shown as a row in the view 


7 Manage Jenkins 


Dashboard 
A Credentials Customizable view that contains various portlets containing information about your 
job(s) 
® Disk usage 
Delivery Pipeline View 
ony 
8 Jenkins 100K Shows one or more delivery pipeline instances 
Deployment Dashboard 
Bulld Queue = View for Deployment Dashboard. This dashboard intearates with an artifact recositor 


No bullds In the queue 
q oK 
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2. Select Jobs and save the details. 


Jenkins My Monitoring 
@& New Item 
& People 
T> Build History 
Edit View 
© Delete View 
L Project Relationship 
$= Check File Fingerprint 
g. Manage Jenkins 
A Credentials 
e Disk usage 


Jenkins 100K 


Build Queue 


No builds in the queue. 


Nome My Monitoring 


Description 


[Escaped HTML] Preview 
Fitter bulid queue 
Fitter bulld executors 
Job Filters 
Status Filter 


All selected jobs 


Recurse in subfolders 


Jobs vi AntExamplet 


ZZ ~ 


è 


® 
@ 


-@ 


3. Click on the newly created view, and we will get a similar type of screen as 
given in the following screenshot: 


My Monitoring 


AntExample1 \CounterApp, petClinic-Test 


settle- 


Possible Culprits: miteshS1 


settle-build 


aws-provisioning 


To get more details on plugin, visit https: //wiki.jenkins-ci.org/display/ 


JENKINS /Build+Monitor+Plugin. 
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Managing access control and 
authorization 


Jenkins supports several security models, and can integrate with different user 
repositories. 


1. Go to the Jenkins dashboard, click on Manage Jenkins, and click on 
Configure Global Security. 


2. Click on Enable security. 


(a Configure Global Security 


C Enable security 


© 
Markup Formatter Escaped HTML 
Treats all input as plain text. HTML unsafe characters like < and & are escaped to their respective 
character entities. 
L] Prevent Cross Site Request Forgery exploits © 
v| Use browser for metadata download © 


All options will be visible once we enable security, as shown in the 
following screenshot: 


E) Configure Global Security 


[V] Enable security 


(2) 
TCP port for JNLP slave agents () Fixed : + © 

Random © Disable © 
Disable remember me o (2) 


Access Control Security Realm 


_ Delegate to servlet container (2) 
( Jenkins’ own user database (2) 
D LDAP 
ÙO Unix user/group database (2) 
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3. Click on Jenkins' own user database. Click on Save. 


[v] Enable security 


Disable remember me 


Access Control 


| gj Configure Global Security 


TCP port for JNLP slave agents ©) Fixed : 


Random © Disable 


O 


Security Realm 


Delegate to servlet container 


®) Jenkins’ own user database 


[¥] Allow users to sign up 


LDAP 


4. Now, click on the sign up link on the top-right corner. Provide Username, 
Password, Full name, and E-mail address. 


@ Jenkins 


Jenkins 


= New Item 
& People 
> Build History 

Project Relationship 
s= Check File Fingerprint 
7 Manage Jenkins 
A Credentials 


@ Disk usage 


G Jenkins 100K 


A 


Sign up 
Username mitesh51 
Password eeccece 


Confirm password: eecececeee 


Full name MiteshS 


E-mail address mitesh.83temp@gmail.com 


log in | sign up 
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5. Click on the log in link on the dashboard. 


® Jenkins 


Jenkins 


@& New Item 
& People 
TÈ Build History 
Project Relationship 
ê= Check File Fingerprint 
g Manage Jenkins 
@ Credentials 
@ Disk usage 


g Jenkins 100K 


User: mitesh1983 


Password: eeeceee| 


CS o ioon signup 


Remember me on this computer 


Create an account if you are not a member yet 


We will get the Jenkins dashboard with the username in the top-right corner. 


@ Jenkins 


Jenkins 


& New Item 
& People 
=> Build History 
Project Relationship 
è= Check File Fingerprint 
g- Manage Jenkins 
A Credentials 
& My Views 
@ Disk usage 


8 Jenkins 100K 


CS © esn og out 


All 


+ 


s W Name | 
=) AntExample1 
i] LA, AntExampleGit 


wv A CounterApp-Sonar 


interApp 


e) CounterArtifactoryTest 


Last Success 
1 hr 30 min - 
#15 

6 days 23 hr - 
#3 


1 mo 11 days - 


#23 


NIA 


ze 


1 mo 11 days - 


Last Failure 


1 hr 38 min - 
#13 


13 days - #1 


1 mo 11 days - 


{Wadd description 


Last Duration 


6.8 sec 52) 
11 sec K) 
57 se &) 
4min3isec $) 
3min 55sec 7) 


[131] 


Managing and Monitoring Jenkins 


6. Click on People to verify all users. 


@ Jenkins CE o esn | tog out 


Jenkins DISADEE AUTO REFRESH 


E New tt 
& New Item & People 
& People 


w Build History includes all known “users”, includ! ing login identi ties which the current security realm can enumerate 
as well as people mentioned in commit messages in recorded changelogs. 
Project Relationship 


User Id Name Last Active On 
$= Check File Fingerprint f 
5 5 2 days 3 CounterApp 
3K Manage Jenkins & miteshS1 mitesh51 2 days 3 hr ounterApp 
A Credentials & cleanclouds9 cleanclouds9 NIA 
My Views 
& myvi & mitesh1984 MiteshS NIA 
® Disk usage 
A & mitesh.soni83 mitesh.soni83 NIA 
4g Jenkins 100K 
& mitesh1983 Mitesh NIA 
Build Queue > 
& anonymous anonymous NIA 


No builds in the queue. 


7. On the Jenkins dashboard, click on Manage Jenkins. Click on Manage Users. 


® Jenkins c Žž ENE 


Jenkins Jenkins’ own user database QISAALE AUTO Ri 


$È Back to Dashboard Users 
g Manage Jenkins 


These users can log into Jenkins. This is a sub set of this list. which also contains auto-created users 
& Create User who really just made some commits on some projects and have no direct Jenkins access. 


User Id Name 


& mitesh1983 Mitesh 


& mitesh1984 MiteshS S 


We can edit user details on the same page. This is a subset of users, which 
also contains auto-created users. 
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Maintaining roles and project-based 
security 


For authorization, we can define Matrix-based security on the Configure Global 
Security page. 


1. Add group or user and configure security based on different sections such as 
Credentials, Slave, Job, and so on. 


2. Click on Save. 


Authorization 
) Anyone can do anything 
Legacy mode 
) Logged-in users can do anything 


©) Matrix-based security 


User/group Overall Credentials Slave 
AdministerConfigureUpdateCenterReadRunScriptsUploadPluginsCreateDeleteManageDomainsUpdateViewBuildC onfigureConnectCreateDeleteDisconnect| 
Anonymous [] C C [ 5 J oO o O J}O} O O DE O 
Add 
User/group to add: 


) Project-based Matrix Authorization Strategy 


Escaped HTML 


Treats all input as plain text. HTML unsafe characters like < and & are escaped to their respective character entities. 


We can use multiple users for matrix-based security, as shown in the 
following screenshot: 


Authorization 


) Anyone can do anything 
D Legacy mode 
2 Logged-in users can do anything 


©) Matrix-based security 
User Overall Credentials Slave 
ser/group 


AdministerConfigureUpdateCenterReadRunScriptsUploadPluginsCreateDeleteManageDomainsUpdateViewBuildConfigureConnectCreateDeleteDisconnect 
Anonymous Oo O O O i| ] [ ] ] ] [ O 


& mitesh1983 v v) v) M v) v) v) vi v v M v) v) vi v M 


Add 
User/group to add: mitesh1983 


: Project-based Matrix Authorization Strategy 


Escaped HTML 


Treats all input as plain text. HTML unsafe characters like < and & are escaped to their respective character entities 
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3. Try to access the Jenkins dashboard with a newly added user who has no 
rights, and we will find the authorization error. 


@ Jenkins MiteshS | 10g out 


Jenkins 


Access Denied 


[=] mitesh1984 is missing the Overall/Read permission 


4. Now provide overall read rights; build, read, and workspace rights for job 
for newly added users. 


Authorization 
Anyone can do anything 
Legacy mode 
Logged-in users can do anything 


©) Matrix-based security 


User/aroup Overall Credentials Slave 
AdministerConfigureUpdateCenterReadRunScriptsUploadPluginsCreateDeleteManageDomainsUpdateViewBuildC onfigureConnectCreateDeleteDisconnect 
ê mitesh1983 v v v v) v v] v w] vy) MM v] v] v Mi v 
Anonymous o [ ] oO oa ] g o [ 
ê mitesh1984 o [ [ [ v v) v) v M v 
Add 


User/group to add: mitesh1984 


5. Log in with the newly added user and verify that we can see the dashboard. 
We can't see the Manage Jenkins link as we have provided those rights. 


@ Jenkins CE o ites ioo out 


Jenkins v BLE AUTO REFRESH 


@& New item "Madd desenpti 
All * 
& People 
— $ W Name: Last Success Last Failure Last Duration 
æ Build History 
se 3 
Project Relationship v 68s w& 
$Z Check File Fingerprint i) i a we) 
z% Manage Jenkins w ý z da & 
Credentials r 
A w a 3! 1 da’ m 1 se we 
& My Views 
r d mo 15 days - # mi > 
@ Disk usage e) 
â Jenkins 100K 7) A p J n a rv &) 
v : days-# n © 
Build Queue = 
builds i queue e # F , © 
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6. Click on any build job. The build link is available as we have given rights but 
the configure link is not available as rights were not given for it. 


Jenkins AntExample1 OGABLE AUTO REFRESH 


È Back to Dashboard Project AntExample1 


à Status 
(Wadd description 


> Changes 
Disable Project 
N 
= Workspace Project disk usage information + trend graph 


© Build Now ®Disk Usage: Workspace 61 MB (On slaves 61 MB, Non slave workspaces -), Builds 232 KB (Locked -), Job 
directory 31 MB 
8 Delete Project i 


g. Configure a 
Atenami 


E Subversion Polling Log 


rkspace 


A Recent Changes 


Build History trend = er 
gas Permalinks 
#14 A 
-= e Last build (#15), 1 hr 54 min ago 
g #3 J ) e Lasi le build (#15), 1 hr 54 min ago 
e Las cessful build (#15), 1 min ago 
Q #2 AM * Las! d build (#13), 2 hr 3 go 
© Last unsuccessful build (#13), 2 hr 3 min ago 
em 


7. We can also set Project-based Matrix Authorization Strategy. 


Authorization 


O Anyone can do anything 
O Legacy mode 

D Logged-in users can do anything 
© Matrix-based security 


@ Project-based Matrix Authorization Strategy 


User/group Overall Credentials Slave 
AdministerConfigureUpdateCenterReadRunScriptsUploadPluginsCreateDeleteManageDomainsUpdateViewBuildC onfigureConnectCreateDeleteDisconnect| 
ê mitesh1983 v v v v M M v] v 4 My v v] M v] v] 
ê mitesh1984 [C oO v Ji o CE 7] ToC i E O ry a 
Anonymous ] [ [ 
User/group to add: oe 
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8. Go toa specific build jobs' configuration and Enable project-based security. 


Project name AntExample1 


Description 


[Escaped HTML] Preview 


C Discard Old Builds (2) 
M] Enable project-based security 
Block inheritance of global authorization matrix @ 
Credentials Job Run SCM 
User/group 
CreateDeleteManageDomainsUpdateViewBuildCancelConfigureDeleteDiscoverReadWorkspaceDeleteUpdate Tag 
Anonymous [ [ [ o ] ] T 
& mitesh1983 [v] w w] v ¥) mM M v v v] v] v v v v gB 
O MO ] O Oe 


ê mitesh1984 


9. Assign rights to different users and log in with the specific username to 
verify whether authorization strategy is working or not. 


® Jenkins CE o ies tog out 


& People 
W Name: Last Success Last Failure Last Duration 


Build History 


Project Relationship 16 mi 3 sec 


All 
s 

= Check File Fingerprint (=) i frn EE E ey 
(*) merApp NA 1 mo 11 days - #4 4 min 31 se 
< 


& My Views 


© Disk usage 


É Jenkins 100K 


jiii egend GYRSStoral GYRSStortaivres FJ RSS for just latest builds 


Build Queue 


No builds in the queue 


10. Verify the build details also, as shown in the following screenshot: 
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@ Jenkins CE o es tog out 


Ske Deshbost Project AntExample1 

Status tA 
> Changes @Disk Usage: Workspace 61 MB (On slaves 61 MB, Non slave workspaces -), Builds 232 KB (Locked -), Job 
O Subversion Polling Log rectory 31 
ZF Recent Chang 


Build History trend = 


Permalinks 


bd 
z 


| 


2 
a 


2 
K 


z 
è 


e©®e@eee6eecé 
H 


is 13 | 


We've covered basics of security configuration in Jenkins. Explore more on the 
other options as an exercise. In case, authorization is not correctly set, then it can be 
corrected by editing config.xml. Consider it as self-study. 


Audit Trail Plugin — an overview and 
usage 


Audit Trail Plugin keeps a log of users who performed particular Jenkins operations, 
such as configuring jobs. This plugin adds an Audit Trail section in the main Jenkins 
configuration page. 


Install the Audit Trail Plugin. 


@ Jenkins Mitesh {log out 


Jenkins Plugin Manager 
$ Back to Dashboard 
g- Manage Jenkins 
Filter: Audit Trail 


Installed 
Enabled Name | Version Previously installed version Pinned Uninstall 


Audit Trail 


lv] 21 Uninstall 
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In Jenkins configuration, configure Loggers, as shown in the following screenshot: 


Audit Trail 
Loggers 
Log file 
Log Location /tmp/jenkins_logs (2) 
Log File Size MB 5 © 
Log File Count 5 (2) 


Add Logger v» 


Advanced... 


Stop the Jenkins server and start it again. Run any build job and open log files to 
verify log records. 


jenkins_logs.0.1 (/tmp) - gedit 


File Edit View Search Tools Documents Help 
9 op v se| 6 E AR 


jenkins_logs.0.1 3€ 


May 24, 2015 12:07:09 PM job/CounterApp/ #15 Started by user Mitesh 

May 24, 2015 12:07:26 PM job/CounterApp/com.mkyong$CounterWebApp/ #15 Started 
May 24, 2015 12:07:46 PM CounterApp » CounterWebApp Maven Webapp #15 Started 
on node Jenkins started at 2015-05-24T19:07:11Z completed in Oms completed: 
SUCCESS 

May 24, 2015 12:07:47 PM CounterApp #15 Started by user Mitesh on node Jenkins 
started at 2015-05-24T19:07:09Z completed in 37860ms completed: SUCCESS 


Plain Texty Tab Width: 8v Ln 1, Col 1 INS 


To get more details, visit https: //wiki.jenkins-ci.org/display/JENKINS/ 
Audit+Trail+Plugin. 
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Self-test questions 


Q1. What are the different ways to make slave node online? 


1. 
2. 
3. 
4. 


Launch an agent from the browser on slave 
Run the slave-agent .jnlp command from the command line 
Run java -jar slave.jar 


All of the above 


Q2. For what options does Jenkins monitoring provide charts? 


OM, Fs 3 G9) Oy ES 


CPU 

Memory 

System load average 
HTTP response time 
All of the above 


Q3. What are the options for Security Realm in Jenkins? 


1. Delegate to Servlet Container 

2. Jenkins' own user database 

3. LDAP 

4. Unix user/ group database 

5. All of the above 
Summary 


Whatever good things we build end up building us. In this chapter, we covered 
concepts of master and slave nodes, how to monitor build jobs, and reporting of 
statistics with management features. We also understood how to secure Jenkins 


environment with authentication and authorization configurations by using 
role-based security. We saw how the audit trail plugin stores audit details 


in Jenkins. 


In the next chapter, we will cover some important plugins that add a significant 
value to Jenkins. Let's enjoy the last journey before we say goodbye. 
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Jenkins — Leveraging 
"Must-have" Plugins 


"Strength and growth come only through continuous effort and struggle." 


- Napoleon Hill 


In the last chapter, we covered management and monitoring along with security 
aspects in Jenkins. In security, we understood how authentication and authorization 
works. Now, it is time to recognize the value added by some important plugins. 


This chapter covers advanced usage of Jenkins, which is extremely useful in specific 
scenarios. Scenario-based usage of specific plugins that help development and 
operations teams are covered here for better utilization of Jenkins. Some of these 
plugins are extremely useful in the case of notifications scenario. The following are 
the main topics that we will cover in this chapter: 


Extended E-mail Plugin 
Workspace cleanup Plugin 
Pre-scm-buildstep Plugin 
Conditional BuildStep Plugin 
EnvInject Plugin 

Build Pipeline Plugin 
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Extended Email Plugin 
Email-ext plugin extends functionality of e-mail notifications provided by Jenkins. 


It gives more customization in terms of conditions that cause mail notifications and 
content generation. 


You can install this plugin from the Jenkin's dashboard. 
@ Jenkins CE 
È Back to Dashboard Fiter Email 


7. Manage Jenkins Installed 


Enabled Name | Version Previously installed version Pinned Uninstall 


a s 
s 240 Downgrade to 2.39 Uninstall 


v 115 Downgrade to 1.11 STEN 
t 


Customization is available in three areas: 
e Triggers: We can select the conditions that cause an e-mail notification to 
be sent 


e Content: We can specify the content of each triggered email's subject and 
body; we can use default environment variables within content 


e Recipients: We can specify who should receive an e-mail when it is triggered 
In the Jenkins dashboard, click on Manage Jenkins and then click on Configure 


System. Go to the Extended E-mail Notification section and configure global 
email-ext properties that should match the settings for your SMTP mail server. 
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Extended E-mail Notification 
SMTP server 


Default user E-mail suffix 


Default Content Type 


Use List-ID Email Header 


is) 


Add ‘Precedence: bulk’ Email Header 


Default Recipients 


Reply To List 


Emergency reroute 


Excluded Recipients 


Default Subject 


Maximum Attachment Size 


smtp.gmail.com 


© 


Advanced... 


< 


© © © © © 00000 


HTML (text/html) 


—Joaraicom 


$PROJECT_NAME - Build # $BUILD_NUMBER - $BUILD_ST 


We can also customize the subject, maximum attachment size, default content, 


and so on. 
Default Subject $PROJECT_NAME - Build # $BUILD_NUMBER - $BUILD_S1 @ 
Maximum Attachment Size (2) 
Pee $PROJECT_NAME - Build # SBUILD_NUMBER - a 
$BUILD_STATUS: 
Check console output at $BUILD_URL to view the results. @ 
Default Pre-send Script 
@ 
Additional groovy classpath Add ®© 
O Enable Debug Mode @ 
Enable Security (2) 
O Require Administrator for Template Testing (2) 
Enable watching for jobs (2) 
Default Triggers... 
Content Token Reference ® 


[143] 


Beyond Basics of Jenkins — Leveraging "Must-have" Plugins 


To configure Email-ext specific to build job, enable it in the project configuration 
page. Select the checkbox labeled Editable Email Notification in the Post-build 
Actions. Configure the comma- (or whitespace-) separated list of global recipients, 
subject, and content. In advanced configuration, we can configure pre-send script, 
triggers, email tokens, and so on. 


Editable Email Notification (2) 
Disable Extended Email Publisher (2) 


Allows the user to disable the publisher, while maintaining the settings 
i $DEFAULT_RECIPIENTS @ 


Comma-separated list of email address that should receive notifications for this project. 


Project Reply-To List $DEFAULT_REPLYTO © 


Comma-separated list of email address that should be in the Reply-To header for this project. 
Content Type E 
yp Default Content Type ¥@ 


Default Subject $DEFAULT_SUBJECT ® 


ll $DEFAULT_CONTENT 


© 
Attachments © 
Can use wildcards like ‘module/dist/**/* zip’. See the @includes of Ant fileset for the exact format. The 
base directory is the workspace. 
Attach Build Log Do Not Attach Build Log v (2) 
Content Token Reference © 


The pre-send script feature allows us to write a script that can modify the 
MimeMessage object prior to sending the message. Triggers allow us to configure 
conditions that must be met to send an e-mail. The Email-ext plugin uses tokens to 
allow dynamic data to be inserted into the recipient list, e-mail subject line, or the 
body. For more details, visit https: //wiki.jenkins-ci.org/display/JENKINS/ 
Email-ext+plugin. 


Workspace cleanup Plugin 


The Workspace Cleanup plugin is used to delete the workspace from Jenkins before 
the build or when a build is finished and artifacts are saved. If we want to start a 
Jenkins build with a clean workspace or we want to clean a particular directory 
before each build, then we can effectively use this plugin. Different options are 
available for deleting the workspace. 
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You can install this plugin from the Jenkins dashboard. 


Jenkins Plugin Manager 


» Back to Dashboard 


7 Manage Jenkins 
Filter: workspace 


Installed 
Enabled Name Version Previously installed version Pinned Uninstall 


Workspace Cleanup Plugin 


[x] ; 0.25 Uninstall 


We can apply patterns for files to be deleted based on the status of the build job. 
We can add post-build action for workspace deletion. 


Delete workspace when build is done 


P for fil | 
atterns for files to be deleted Add © 


Apply pattern also on directories 


Clean when status is v] Success[¥] Unstable [Y] Failure [V] Not Built [Y] Aborted 
Don't fail the build if cleanup fails © 
External Deletion Command e 


Add post-build action X 


For more details, visit https ://wiki.jenkins-ci.org/display/JENKINS/ 
Workspace+Cleanup+Plugin. 
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Pre-scm-buildstep Plugin 

The Pre-scm-buildstep plugin allows a specific build step to run before SCM 
checkouts in case we need to perform any build step action on the workspace 
considering any special requirements such as adding a file with some settings for 
the SCM, executing some command to create some file, cleanup, or call other scripts 
that need to be run before checking out. 


You can install this plugin from the Jenkins dashboard. 


Jenkins Plugin Manager 


Æ Back to Dashboard 


7 Manage Jenkins 


Filter: | 9 prel 


Installed 


Enabled Name | Version Previously installed version Pinned Uninstall 


Pre SCM BuildStep Plugin 


M - 0.3 Uninstall 


Select conditional steps from the list, as shown in the following screenshot: 


Conditional step (single) 


Run? 


Never 

Boolean condition 

Build Cause 

Current build status 

Day of week 

Execute Shell 

Execute Windows Batch commands 
Execution node 

File exists 

Files match 

Legacy boolean condition (deprecated) 
Numerical comparison 

Regular expression match 

Strings match 

Time 


Builder 
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Select the conditional steps based on requirement and provide a list of commands 


based on operating systems, as shown in the following screenshot: 


Conditional step (single) 


Run? Always 


Advanced... 


Builder Execute shell 


Command] declare -i nj 


See the list of available environment variables 


For more details, visit https: //wiki.jenkins-ci.org/display/JENKINS/pre- 


scm-buildstep. 
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Conditional BuildStep Plugin 


The Buildstep plugin allows us to wrap any number of other build steps, controlling 
their execution based on a defined condition. 


You can install this plugin from the Jenkins' dashboard. 
Jenkins Plugin Manager 
t Back to Dashboard 
7 Manage Jenkins 
Filter: | © cond| 


Installed 
Enabled Name | Version Previously installed version Pinned Uninstall 


conditional-buildstep 


<) 
= 
Q 
w 


Uninstall 


This plugin defines a few core run conditions such as: 


e Always/Never: To disable a build step from the job configuration 


e Boolean condition: To execute the step if a token expands to a representation 
of true 


e Current status: To execute the build step if the current build status is within 
the configured/specific range 


e File exists/Files match: To execute the step if a file exists, or matches 
a pattern 


e Strings match: To execute the step if the two strings are same 


e Numerical comparison: To execute the build step depending on the result of 
comparing two numbers 


e Regular expression match: This provides a regular expression and a label, 
to execute the build step if the expression matches the label 
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e Time/Day of week: To execute the build job during a specified period of the 
day or day of the week 


e And/Or/Not: Logical operations to enable the combining and sense 
inversion of run conditions 


e Build cause: To execute the build step depending on the cause of the build, 
for example, triggered by timer, user, scm-change, and so on 


e Script condition: Utilize shell script to decide whether a step should 
be skipped 


e Windows Batch condition: Utilize windows batch to decide whether a step 
should be skipped 


Select the Conditional step (single) from the Add build step. 


Conditional step (single) (2) 
Run? File exists a 2) 
File kc2 tt 


Base directory Workspace 


Advanced... 


— Execute shell {v 


Command] geciare +i n 


See the list of available environment variables 
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Select the Conditional steps (multiple) from the Add build step. We can add 


multiple steps to condition in this conditional step. 


Conditional steps (multiple) 


Run? 


Add step to condition ¥ 


Always v (2) 
Advanced... 
Steps to run if condition is met 
Invoke OWASP Dependency-Check analysis 
Path to scan (2) 
Advanced... 


For more details, visit https: //wiki.jenkins-ci.org/display/JENKINS/ 


Conditional+BuildStep+Plugin. 


Envinject Plugin 


We know that different environments such as Dev, Test, and Production requires 


different configuration. 


Install this plugin from the Jenkins dashboard. 
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Jenkins 


Enabled 


Plugin Manager 


$ Back to Dashboard 


7 Manage Jenkins 


environment for the 
builds 


Filter | envinject 
Installed 
Name | Version Previously installed version Pinned Uninstall 
Environment Injector Plugin 
This plugin makes it 
possible to set an 1.91.2 Uninstall 


The EnvInject plugin provides the facility to have an isolated environment for 


different build jobs. The EnvInject plugin injects environment variables at node 
startup, before or after a SCM checkout for a run, as a build step for a run, and so 
on. Select Inject environment variables to the build process specific to the build job. 


M Inject environment variables to the build process (2) 
Properties File Path © 
Properties Content MAVEN_HOME=/usr/maven 

(2) 
Script File Path © 
Script Content 

© 
Evaluated Groovy script 

(2) 
O Inject passwords to the build as environment variables 


For more details, visit https: //wiki.jenkins-ci.org/display/JENKINS/ 


Envinject+Plugin. 
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Build Pipeline Plugin 


Continuous Integration has become a popular practice for application development. 
The Build Pipeline plugin provides a pipeline view of upstream and downstream 
connected jobs that typically form a build pipeline with the ability to define manual 
triggers or approval process. We can create a chain of jobs by orchestrating version 
promotion through different quality gates before we deploy it in production. 


Install this plugin from the Jenkins dashboard. 


Jenkins ¥ Plugin Manager 


* Back to Dashboard 


7 Manage Jenkins 


Filter: |9 build pip| 


Installed 


Enabled Name | Version 


Build Pipeline Plugin 
This ol R 


Downgrade to 1.4.5 


Previously installed version Pinned Uninstall 


Uninstall 


We have already installed the Dashboard View plugin. We will create a pipeline 
for four build jobs. Let's assume we have four build jobs, as shown in the following 


diagram, where the objective of each build job is mentioned: 


Settle-test Settle-build 


e Create a WAR 
file 


Settle-aws- 

provisioning 

¢ Provision a VM 
in a Cloud 


e Execute Unit 
Tests 


Settle- 
deploy 


* Deploy WAR 
to VM 
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1. Create a new view and select Build Pipeline View. 


@ Jenkins C 


E New item ê set-pipeline 
& Poop Build Monitor View 
TZ Build History Shows a highly visible status of selected jobs. ideal as an Extreme Feedback Device to be displayed on a 
fice wa 
Project Relationship 
ca onan Build Pipeline View 
45 Check File Fingerprint shows the jobs in a build pipeline view. The complete pipeline of jobs that a version propagates throug! 
7 oles Dashboard 
A Credenti t aining à 
@ Disk usage Delivery Pipeline View 
E Jenkins 100K 
Deployment Dashboard 
View f à ard able 
Build Queue = ve ns of a specified arhfactid It a talus o 
rinsing 
No builds in the que: 
List View 
h e disp 
Build Executor Status =- 


2. Provide a description and select the layout from the configuration on the 
build pipeline. 

3. Select an initial job and the number of displayed builds and save the 
configuration. 


® Jenkins CS 


& New item 
& Peopie 


> Build History 


set-pipeline 


Edit View | 2 
© Delete View 

Pr t Relat hi 
‘ eck File Fingerprint ®© 
7. Manage Jenkins — EES ®© 
A Credent 
e sage 

parung Based on upstream/downstream relationship 
Q Jenkins 100K 
Build Queue n settie-test f 


No builds in the que 


AL 
Build Executor Status = Re F A 
= master Aba mar kinnet an nis . D a a 


2 idie E] = 
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4. Inaconfiguration of the build pipeline, select job to trigger parameterized 
build as settle-buildjob in Post-build Actions. It will be the first build job 
in the pipeline. 

Jenkins set-pipeline settle-test configuration 
Trigger parameterized build on other projects © 
Build Triggers 
Projects to build settle-build 
Trigger when build is Stable i © 
Trigger build without parameters [X] © 
Add Parameters = 
Add trigger... 
Add post-build action ~ 
5. Inasettle-build job, trigger the parameterized build on the settle-aws- 


provisioning job in Post-build Actions. 


Jenkins set-pipeline settle-build configuration 


Trigger parameterized build on other projects 


Build Triggers 


Projects to build 


Trigger when build is 


settle-aws-provisioning 


Stable J 
Trigger build without parameters [¥) (2) 
Add Parameters v 
Add trigger... 
Add post-build action ~ 
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6. Inasettle-aws-provisioning job, the manual build steps for a 
settle-deploy job in Post-build Actions. 


Jenkins set-pipeline settle-aws-provisioning configuration 
Post-build Actions 


Build other projects (manual step) 


Downstream Project Names settle-deploy 


Add Parameters < 


Add post-build action ~ 


7. Inasettle-aws-provisioning job, trigger the parameterized build on the 
settle-deploy job in Post-build Actions. In the sett 1le-deploy build job, 
we can write script or execute commands so that it can deploy war file to 
newly provisioned virtual machine in the cloud environment. 


Jenkins set-pipeline settle-aws-provisioning configuration 


Copy artifacts from another project 
Project name settle-build 


Which build Latest successful build 


O Stable build only 


Artifacts to copy =) war 
Artifacts not to copy 
Target directory 


Parameter filters 
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8. Go to the dashboard view, which we created earlier, and verify the pipeline 
created after our configuration in build jobs in the previous section. The new 
build pipeline will be created as shown in the following diagram: 


® Jenkins 


Jenkins set-pipeline ENABLE AUTO REFRESH 


Build Pipeline 
Zi ¢ = © d 


Run itoy Configure AddSiep = Dette damage 


#49 settle-test #31 settle-build #27 settle-aws-provisioning #23 settle-deploy 
= . =. m 


(Pipine) 726 sette-awe-provsioning)) We [#22 ette-dplay 
. a 7” J 


For more details, visit https: //wiki.jenkins-ci.org/display/JENKINS/ 
Build+Pipeline+Plugin. 


Self-test questions 


Q1. In which areas does the Extended E-mail plugin provide customization? 


1. Triggers 

2. Content 

3. Recipients 

4. All of the above 


Q2. The Workspace cleanup plugin provides an option to clean the workspace when 
status of build is: 


1. Success 

2. Unstable 

3. Failure 

4. Not Built 

5. Aborted 

6. All of the above 
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Summary 


We learned how to use some important plugins to aid the existing features of Jenkins 
to address specific requirements. We covered all basic usage of Jenkins, including 
installing runtime environment, creating build jobs, using Jenkins on Cloud, 
monitoring, management, security, and additional plugins. For the scope of this 
book, this seems sufficient. Next step is about provisioning resources dynamically in 
Cloud environment to achieve end to end automation in the DevOps journey. 


If you want a happy ending, that depends of course on where you stop your story. 
We certainly know where to stop ours! 
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